ocf_heartbeat_iSCSILogicalUnit(7)

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

NAME

6       ocf_heartbeat_iSCSILogicalUnit - Manages iSCSI Logical Units (LUs)
7

SYNOPSIS

9       iSCSILogicalUnit [start | stop | status | monitor | meta-data |
10                        validate-all]
11

DESCRIPTION

13       Manages iSCSI Logical Unit. An iSCSI Logical unit is a subdivision of
14       an SCSI Target, exported via a daemon that speaks the iSCSI protocol.
15

SUPPORTED PARAMETERS

17       implementation
18           The iSCSI target daemon implementation. Must be one of "iet",
19           "tgt", or "lio". If unspecified, an implementation is selected
20           based on the availability of management utilities, with "iet" being
21           tried first, then "tgt", then "lio".
22
23           (optional, string, no default)
24
25       target_iqn
26           The iSCSI Qualified Name (IQN) that this Logical Unit belongs to.
27
28           (required, string, no default)
29
30       lun
31           The Logical Unit number (LUN) exposed to initiators.
32
33           (required, integer, no default)
34
35       path
36           The path to the block device exposed. Some implementations allow
37           this to be a regular file, too.
38
39           (required, string, no default)
40
41       scsi_id
42           The SCSI ID to be configured for this Logical Unit. The default is
43           the resource name, truncated to 24 bytes.
44
45           (unique, optional, string, default "default")
46
47       scsi_sn
48           The SCSI serial number to be configured for this Logical Unit. The
49           default is a hash of the resource name, truncated to 8 bytes.
50
51           (unique, optional, string, default "c21f969b")
52
53       vendor_id
54           The SCSI vendor ID to be configured for this Logical Unit.
55
56           (optional, string, no default)
57
58       product_id
59           The SCSI product ID to be configured for this Logical Unit.
60
61           (optional, string, no default)
62
63       tgt_bstype
64           TGT specific backing store type. If you want to use aio, make sure
65           your tgtadm is built against libaio. See tgtadm(8).
66
67           (optional, string, no default)
68
69       tgt_bsoflags
70           TGT specific backing store open flags (direct|sync). See tgtadm(8).
71
72           (optional, string, no default)
73
74       tgt_device_type
75           TGT specific device type. See tgtadm(8).
76
77           (optional, string, no default)
78
79       additional_parameters
80           Additional LU parameters. A space-separated list of "name=value"
81           pairs which will be passed through to the iSCSI daemon´s management
82           interface. The supported parameters are implementation dependent.
83           Neither the name nor the value may contain whitespace.
84
85           (optional, string, no default)
86
87       allowed_initiators
88           Allowed initiators. A space-separated list of initiators allowed to
89           connect to this lun. Initiators may be listed in any syntax the
90           target implementation allows. If this parameter is empty or not
91           set, access to this lun will not be allowed from any initiator, if
92           target is not in demo mode.
93
94           This parameter is only necessary when using LIO.
95
96           (optional, string, no default)
97
98       lio_iblock
99           LIO iblock device name, a number starting from 0.
100
101           Using distinct values here avoids a warning in LIO "LEGACY: SHARED
102           HBA"; and it is necessary when using multiple LUNs started at the
103           same time (eg. on node failover) to prevent a race condition in
104           tcm_core on mkdir() in /sys/kernel/config/target/core/.
105
106           (optional, integer, default 0)
107

SUPPORTED ACTIONS

109       This resource agent supports the following actions (operations):
110
111       start
112           Starts the resource. Suggested minimum timeout: 10.
113
114       stop
115           Stops the resource. Suggested minimum timeout: 10.
116
117       status
118           Performs a status check. Suggested minimum timeout: 10. Suggested
119           interval: 10.
120
121       monitor
122           Performs a detailed status check. Suggested minimum timeout: 10.
123           Suggested interval: 10.
124
125       meta-data
126           Retrieves resource agent metadata (internal use only). Suggested
127           minimum timeout: 5.
128
129       validate-all
130           Performs a validation of the resource configuration. Suggested
131           minimum timeout: 10.
132

EXAMPLE

134       The following is an example configuration for a iSCSILogicalUnit
135       resource using the crm(8) shell:
136
137           primitive p_iSCSILogicalUnit ocf:heartbeat:iSCSILogicalUnit \
138             params \
139               target_iqn=string \
140               lun=integer \
141               path=string \
142             op monitor timeout="10" interval="10" depth="0"
143

AUTHOR

148       Linux-HA contributors (see the resource agent source for information
149       about individual authors)
150
151
152
153resource-agents 3.9.2             03/24/2017           OCF_HEARTBEAT_ISCSIL(7)