ocf_heartbeat_iSCSITarget(7)

1OCF_HEARTBEAT_ISCSIT(7)       OCF resource agents      OCF_HEARTBEAT_ISCSIT(7)
2
3
4

NAME

6       ocf_heartbeat_iSCSITarget - iSCSI target export agent
7

SYNOPSIS

9       iSCSITarget [start | stop | monitor | meta-data | validate-all]
10

DESCRIPTION

12       Manages iSCSI targets. An iSCSI target is a collection of SCSI Logical
13       Units (LUs) exported via a daemon that speaks the iSCSI protocol.
14

SUPPORTED PARAMETERS

16       implementation
17           The iSCSI target daemon implementation. Must be one of "iet",
18           "tgt", or "lio". If unspecified, an implementation is selected
19           based on the availability of management utilities, with "iet" being
20           tried first, then "tgt", then "lio".  (optional, string, no
21           default)
22
23       iqn
24           The target iSCSI Qualified Name (IQN). Should follow the
25           conventional "iqn.yyyy-mm.<reversed domain name>[:identifier]"
26           syntax.  (unique, required, string, no default)
27
28       tid
29           The iSCSI target ID. Required for tgt.  (unique, optional, integer,
30           no default)
31
32       portals
33           iSCSI network portal addresses. Not supported by all
34           implementations. If unset, the default is to create one portal that
35           listens on .  (optional, string, default 0.0.0.0:3260)
36
37       allowed_initiators
38           Allowed initiators. A space-separated list of initiators allowed to
39           connect to this target. Initiators may be listed in any syntax the
40           target implementation allows. If this parameter is empty or not
41           set, access to this target will be allowed from any initiator.
42           (optional, string, no default)
43
44       incoming_username
45           A username used for incoming initiator authentication. If
46           unspecified, allowed initiators will be able to log in without
47           authentication. This is a unique parameter, as it not allowed to
48           re-use a single username across multiple target instances.
49           (unique, optional, string, no default)
50
51       incoming_password
52           A password used for incoming initiator authentication.  (optional,
53           string, no default)
54
55       additional_parameters
56           Additional target parameters. A space-separated list of
57           "name=value" pairs which will be passed through to the iSCSI
58           daemon's management interface. The supported parameters are
59           implementation dependent. Neither the name nor the value may
60           contain whitespace.  (optional, string, no default)
61

SUPPORTED ACTIONS

63       This resource agent supports the following actions (operations):
64
65       start
66           Starts the resource. Suggested minimum timeout: 10.
67
68       stop
69           Stops the resource. Suggested minimum timeout: 10.
70
71       status
72           Suggested minimum timeout: 10. Suggested interval: 10.
73
74       monitor
75           Performs a detailed status check. Suggested minimum timeout: 10.
76           Suggested interval: 10.
77
78       meta-data
79           Retrieves resource agent metadata (internal use only). Suggested
80           minimum timeout: 5.
81
82       validate-all
83           Performs a validation of the resource configuration. Suggested
84           minimum timeout: 10.
85

EXAMPLE

87       The following is an example configuration for a iSCSITarget resource
88       using the crm(8) shell:
89
90           primitive p_iSCSITarget ocf:heartbeat:iSCSITarget \
91             params \
92               iqn=string \
93             op monitor timeout="10" interval="10" depth="0"
94

AUTHOR

99       Linux-HA contributors (see the resource agent source for information
100       about individual authors)
101
102
103
104resource-agents 3.9.2             07/08/2011           OCF_HEARTBEAT_ISCSIT(7)