OCF_HEARTBEAT_ISCSIT(7)
NAME
ocf_heartbeat_iSCSITarget - iSCSI target export agent
SYNOPSIS
iSCSITarget [start | stop | 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", 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) - iqn
- The target iSCSI Qualified Name (IQN). Should follow the
conventional "iqn.yyyy-mm.<reversed domain name>[:identifier]"
syntax. (required, string, no default) - tid
- The iSCSI target ID. Required for tgt. (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) - 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. (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: 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 iSCSITarget resource
using the crm(8) shell: - primitive example_iSCSITarget ocf:heartbeat:iSCSITarget \
params \iqn=string \op monitor timeout="10" interval="10" depth="0"
SEE ALSO
http://www.linux-ha.org/wiki/iSCSITarget_(resource_agent)
AUTHOR
- Linux-HA contributors (see the resource agent source for information about individual authors)