community.general.open_iscsi – Manage iSCSI targets with Open-iSCSI¶
Note
This plugin is part of the community.general collection (version 2.5.1).
To install it use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.open_iscsi
.
Synopsis¶
Discover targets on given portal, (dis)connect targets, mark targets to manually or auto start, return device nodes of connected targets.
Requirements¶
The below requirements are needed on the host that executes this module.
open_iscsi library and tools (iscsiadm)
Parameters¶
Examples¶
- name: Perform a discovery on sun.com and show available target nodes
community.general.open_iscsi:
show_nodes: yes
discover: yes
portal: sun.com
- name: Perform a discovery on 10.1.2.3 and show available target nodes
community.general.open_iscsi:
show_nodes: yes
discover: yes
ip: 10.1.2.3
# NOTE: Only works if exactly one target is exported to the initiator
- name: Discover targets on portal and login to the one available
community.general.open_iscsi:
portal: '{{ iscsi_target }}'
login: yes
discover: yes
- name: Connect to the named target, after updating the local persistent database (cache)
community.general.open_iscsi:
login: yes
target: iqn.1986-03.com.sun:02:f8c1f9e0-c3ec-ec84-c9c9-8bfb0cd5de3d
- name: Disconnect from the cached named target
community.general.open_iscsi:
login: no
target: iqn.1986-03.com.sun:02:f8c1f9e0-c3ec-ec84-c9c9-8bfb0cd5de3d
Authors¶
Serge van Ginderachter (@srvg)