iscsid / tgtd¶
This page is the starting point for the iscsi role: the containers iscsid and tgtd, on the compute, control and
storage nodes of the example inventory, selected by the tag iscsi. Component dependencies
§2 lists it "only if enable_iscsid (cinder LVM/iSCSI or ironic)". The
lists below say where the study covers how to operate it, its impact, its dependencies and the evidence, what to check
around a run and what stays open; the service card follows them.
Where to look¶
Operate¶
- Scenario: Reconfigure a single service §3 (VM impact: NOT AVAILABLE)
No operation page gives a command line for the iscsi tag, and no risk register item is about a run of this tag. What
the study says about running it is in the rows linked under Impact and risk and in fact sheet D
§5.2.
Impact and risk¶
Dependencies¶
- Dependencies: Component dependencies §2, Component dependencies §5
Evidence¶
- Fact sheet: fact sheet D §5.2
- Image side: Kolla images §5 (rows
iscsid,tgtd)
Before and after a run¶
- Tags §3.1, row
iscsi: safe on its own "with care, per host batch"; the row names no prerequisite. - Reconfigure a single service
§3:
iscsiis one of the tags that can restart the containers that Tags §3.1 traces to running VMs CODE; what those restarts do to running VMs is NOT AVAILABLE.
Known limits and open points¶
- What is not known, rows
iscsidandtgtd: the sources do not establish, for aniscsidrestart, whether existing sessions are kernel-held and whether attach/detach during the window fails; for atgtdrestart, whether tgtd loadstargets.confitself or keeps targets only in memory, and so whether a restart cuts disk I/O for VMs that use LVM volumes from that host. Same table: whether removing theiscsi_infovolume produces a new IQN at the next start, and whether that breaks backend ACLs. - fact sheet D §5.2,
bullets "Host interaction" (bootstrap-servers removes host
open-iscsi/iscsi-initiator-utils), "VM impact (NOT AVAILABLE)", "tgtd restart (consequences NOT AVAILABLE)" and "Precheck oddity" (it checks thatiscsi_port3260 is free on the iscsid hosts, but 3260 is the target (tgtd) port). - fact sheet D
§7, item
11: iscsid runs at debug
-d 8; the precheck tests port 3260 on iscsid hosts. - fact sheet D §8: NOT AVAILABLE: what an iscsid, tgtd or multipathd restart does to attached volumes under I/O (session state, path failover, the guest view); for tgtd, whether the LVM targets come back without a cinder-volume restart.
- R14: a
bootstrap-serversre-run on a live host removes host packages (open-iscsi,libvirt*,chrony, …). - Kolla images §6, item 19: the iSCSI initiator name is stable per
iscsi_infovolume across restart and recreate CODE. NOT AVAILABLE Whether removing the volume produces a new IQN at the next start, and whether that breaks backend ACLs keyed on the old one. - Known bugs and limitations, Open
questions and Findings have no entry on
iscsidortgtd.
Service card¶
The rows of the card are explained in How to read a service card.
| Item | Value |
|---|---|
| Play | site.yml:512 |
| Tags | iscsi |
| Play host patterns | iscsid, tgtd |
| Node types in play (example inventory) | compute, control, storage |
| Node types running its containers | compute, control, storage |
| Containers | iscsid, tgtd |
deploy/reconfigure flow (tasks/) |
config-host → config → check-containers → flush handlers |
| Task files | check-containers.yml, check.yml, config-host.yml, config.yml, deploy-containers.yml, deploy.yml, main.yml, precheck.yml, pull.yml, reconfigure.yml, stop.yml, upgrade.yml |
| Templates | iscsid.json.j2, tgtd.json.j2 |
| Handlers (definition order) | Restart iscsid container; Restart tgtd container |
| Key variables | enable_iscsid, enable_cinder_backend_lvm |
| Role dependencies | common (meta) |
Related¶
- Cinder — cinder-volume (LVM) depends on this role
- Nova — nova-compute depends on it for volume attach
- Reconfigure a single service
§3 — the tags
that can restart containers traced to running VMs,
iscsiamong them - Component dependencies §5 — what lands on a compute host,
iscsidincluded - Components — the other component pages