ocf_heartbeat_iSCSILogicalUnit (7)

iSCSILogicalUnit [start | stop | status | monitor | meta-data | validate-all]

Manages iSCSI Logical Unit. An iSCSI Logical unit is a subdivision of an SCSI Target, exported via a daemon that speaks the iSCSI protocol.

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.

(unique, 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.

(unique, 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)

allowed_initiators

Allowed initiators. A space-separated list of initiators allowed to connect to this lun. Initiators may be listed in any syntax the target implementation allows. If this parameter is empty or not set, access to this lun will not be allowed from any initiator, if target is not in demo mode.

This parameter is only necessary, when using LIO.

(optional, string, no default)

This resource agent supports the following actions (operations):

start

Starts the resource. Suggested minimum timeout: 10.

stop

Stops the resource. Suggested minimum timeout: 10.

status

Performs a status check. Suggested minimum timeout: 10. Suggested interval: 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.

The following is an example configuration for a iSCSILogicalUnit resource using the crm(8) shell:

primitive p_iSCSILogicalUnit ocf:heartbeat:iSCSILogicalUnit \
  params \
    target_iqn=string \
    lun=integer \
    path=string \
  op monitor timeout="10" interval="10" depth="0"

\m[blue]http://www.linux-ha.org/wiki/iSCSILogicalUnit_(resource_agent)\m[]

Linux-HA contributors (see the resource agent source for information about individual authors)