table of contents
other versions
- jessie 1:3.9.3+git20121009-3.1
- jessie-backports 1:4.0.0~rc1-4~bpo8+1
- stretch 1:4.0.0~rc1-4
- testing 1:4.2.0-1
- unstable 1:4.2.0-2
OCF_HEARTBEAT_ISCSIL(7) | OCF resource agents | OCF_HEARTBEAT_ISCSIL(7) |
NAME¶
ocf_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¶
implementationThe iSCSI target daemon implementation. Must be one of
"iet", "tgt", "lio", or "lio-t". If
unspecified, an implementation is selected based on the availability of
management utilities, with "iet" being tried first, then
"tgt", then "lio", then "lio-t".
(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 "RESOURCE_ID")
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 "b3a49b7f")
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)
tgt_bstype
TGT specific backing store type. If you want to use aio,
make sure your tgtadm is built against libaio. See tgtadm(8).
(optional, string, no default)
tgt_bsoflags
TGT specific backing store open flags (direct|sync). See
tgtadm(8).
(optional, string, no default)
tgt_bsopts
TGT specific backing store options. See tgtadm(8).
(optional, string, no default)
tgt_device_type
TGT specific device type. See tgtadm(8).
(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)
lio_iblock
LIO iblock device name, a number starting from 0.
Using distinct values here avoids a warning in LIO "LEGACY: SHARED
HBA"; and it is necessary when using multiple LUNs started at the same
time (eg. on node failover) to prevent a race condition in tcm_core on mkdir()
in /sys/kernel/config/target/core/.
(optional, integer, default 0)
SUPPORTED ACTIONS¶
This resource agent supports the following actions (operations): startStarts 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 CRM SHELL¶
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"
EXAMPLE PCS¶
The following is an example configuration for a iSCSILogicalUnit resource using pcs(8)pcs resource create p_iSCSILogicalUnit ocf:heartbeat:iSCSILogicalUnit \ target_iqn= string \ lun= integer \ path= string \ op monitor timeout="10" interval="10" depth="0"
SEE ALSO¶
http://clusterlabs.org/AUTHOR¶
ClusterLabs contributors (see the resource agent source for information about individual authors)06/07/2017 | resource-agents 4.0.0~rc1-4~bp |