ocf_heartbeat_iSCSILogicalUnit

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, default c21f969b)
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"