Solaris Tip of the Week: iSCSI Failover With COMSTAR
Here is a simple demo you can use for experimenting with high-availability iSCSI configurations with the COMSTAR stack to explore iSCSI failover. COMSTAR is a Solaris framework that centralizes and simplifies the deployment of SCSI targets.
OCF_HEARTBEAT_ISCSIL(7) OCF resource agents OCF_HEARTBEAT_ISCSIL(7)NAME
ocf_heartbeat_iSCSILogicalUnit - Manages iSCSI Logical Units (LUs)
SYNOPSIS
iSCSILogicalUnit [start | stop | monitor | meta-data | validate-all]
DESCRIPTION
Manages iSCSI Logical Unit. An iSCSI Logical unit is a subdivision of an SCSI Target, exported via a daemon that speaks the iSCSI protocol.
SUPPORTED PARAMETERS
implementation
The iSCSI target daemon implementation. Must be one of "iet", "tgt", or "lio". If unspecified, an implementation is selected based on
the availability of management utilities, with "iet" being tried first, then "tgt", then "lio". (optional, string, no default)
target_iqn
The iSCSI Qualified Name (IQN) that this Logical Unit belongs to. (required, string, no default)
lun
The Logical Unit number (LUN) exposed to initiators. (required, integer, no default)
path
The path to the block device exposed. Some implementations allow this to be a regular file, too. (required, string, no default)
scsi_id
The SCSI ID to be configured for this Logical Unit. The default is the resource name, truncated to 24 bytes. (optional, string, default
default)
scsi_sn
The SCSI serial number to be configured for this Logical Unit. The default is a hash of the resource name, truncated to 8 bytes.
(optional, string, no default)
vendor_id
The SCSI vendor ID to be configured for this Logical Unit. (optional, string, no default)
product_id
The SCSI product ID to be configured for this Logical Unit. (optional, string, no default)
additional_parameters
Additional LU parameters. A space-separated list of "name=value" pairs which will be passed through to the iSCSI daemon's management
interface. The supported parameters are implementation dependent. Neither the name nor the value may contain whitespace. (optional,
string, no default)
SUPPORTED ACTIONS
This resource agent supports the following actions (operations):
start
Starts the resource. Suggested minimum timeout: 10.
stop
Stops the resource. Suggested minimum timeout: 10.
monitor
Performs a detailed status check. Suggested minimum timeout: 10. Suggested interval: 10.
meta-data
Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5.
validate-all
Performs a validation of the resource configuration. Suggested minimum timeout: 10.
EXAMPLE
The following is an example configuration for a iSCSILogicalUnit resource using the crm(8) shell:
primitive example_iSCSILogicalUnit ocf:heartbeat:iSCSILogicalUnit
params
target_iqn=string
lun=integer
path=string
op monitor timeout="10" interval="10" depth="0"
SEE ALSO
http://www.linux-ha.org/wiki/iSCSILogicalUnit_(resource_agent)
AUTHOR
Linux-HA contributors (see the resource agent source for information about individual authors)
resource-agents 1.0.3 07/05/2010 OCF_HEARTBEAT_ISCSIL(7)