NAME¶
ocf_heartbeat_iSCSITarget - iSCSI target export agent
SYNOPSIS¶
iSCSITarget [start | stop | status | monitor | meta-data
| validate-all]
DESCRIPTION¶
Manages iSCSI targets. An iSCSI target is a collection of SCSI
Logical Units (LUs) exported via a daemon that speaks the iSCSI
protocol.
SUPPORTED PARAMETERS¶
implementation
The iSCSI target daemon implementation. Must be one of
"iet", "tgt", "lio", "lio-t", or
"scst". 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", then
"scst".
(optional, string, no default)
iqn
The target iSCSI Qualified Name (IQN). Should follow the
conventional "iqn.yyyy-mm.<reversed domain name>[:identifier]"
syntax.
(unique, required, string, no default)
tid
The iSCSI target ID. Required for tgt.
(unique, optional, integer, no default)
portals
iSCSI network portal addresses. Not supported by all
implementations. If unset, the default is to create one portal that listens on
.
(optional, string, default "0.0.0.0:3260")
iser_portals
iSCSI iSER network portal addresses. Not supported by all
implementations.
(optional, string, no default)
allowed_initiators
Allowed initiators. A space-separated list of initiators
allowed to connect to this target. Initiators may be listed in any syntax the
target implementation allows. If this parameter is empty or not set, access to
this target will be allowed from any initiator.
(optional, string, no default)
incoming_username
A username used for incoming initiator authentication. If
unspecified, allowed initiators will be able to log in without authentication.
This is a unique parameter, as it not allowed to re-use a single username
across multiple target instances.
(unique, optional, string, no default)
incoming_password
A password used for incoming initiator authentication.
(optional, string, no default)
additional_parameters
Additional target 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:
10s.
stop
Stops the resource. Suggested minimum timeout: 10s.
status
Performs a status check. Suggested minimum timeout: 10s.
Suggested interval: 10s.
monitor
Performs a detailed status check. Suggested minimum
timeout: 10s. Suggested interval: 10s.
meta-data
Retrieves resource agent metadata (internal use only).
Suggested minimum timeout: 5s.
validate-all
Performs a validation of the resource configuration.
Suggested minimum timeout: 10s.
EXAMPLE CRM SHELL¶
The following is an example configuration for a iSCSITarget
resource using the crm(8) shell:
primitive p_iSCSITarget ocf:heartbeat:iSCSITarget \
params \
iqn=string \
op monitor timeout="10s" interval="10s" depth="0"
EXAMPLE PCS¶
The following is an example configuration for a iSCSITarget
resource using pcs(8)
pcs resource create p_iSCSITarget ocf:heartbeat:iSCSITarget \
iqn=string \
op monitor timeout="10s" interval="10s" OCF_CHECK_LEVEL="0"
AUTHOR¶
ClusterLabs contributors (see the resource agent source for
information about individual authors)