OCF_HEARTBEAT_ISCSIL(7) OCF resource agents OCF_HEARTBEAT_ISCSIL(7)NAMEocf_heartbeat_iSCSILogicalUnit - Manages iSCSI Logical Units (LUs)
SYNOPSIS
iSCSILogicalUnit [start | stop | status | 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.
(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, 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)
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)
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.
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.
EXAMPLE
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"
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 UNKNOWN 03/24/2013 OCF_HEARTBEAT_ISCSIL(7)
