table of contents
other versions
conflicting packages
OCF_HEARTBEAT_ISCSIT(7) | OCF resource agents | OCF_HEARTBEAT_ISCSIT(7) |
NAME¶
ocf_heartbeat_iSCSITarget - iSCSI target export agentSYNOPSIS¶
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¶
implementationThe 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): startStarts 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¶
AUTHOR¶
Linux-HA contributors (see the resource agent source for information about individual authors)02/03/2011 | resource-agents 1.0.3 |