ANSIBLE.OPEN_ISCSI(3)

NAME
open_iscsi - Manage iscsi targets with open-iscsi

DESCRIPTION

Discover targets on given portal, (dis)connect targets, mark targets to manually or auto start, return device nodes of connected targets.

OPTIONS

auto_node_startup
    whether the target node should be automatically connected at startup Choices: yes,no.

discover
    whether the list of target nodes on the portal should be (re)discovered and added to the persistent iscsi database. Keep in mind that iscsiadm discovery resets configurtion, like node.startup to manual, hence combined with auto_node_startup=yes will allways return a changed state. Choices: yes,no.

login
    whether the target node should be connected Choices: yes,no.

node_auth
    discovery.sendtargets.auth.authmethod (default: CHAP)

node_pass
    discovery.sendtargets.auth.password

node_user
    discovery.sendtargets.auth.username

port
    the port on which the iscsi target process listens (default: 3260)

portal
    the ip address of the iscsi target

show_nodes
    whether the list of nodes in the persistent iscsi database should be returned by the module Choices: yes,no.

target
    the iscsi target name.

EXAMPLES

perform a discovery on 10.1.2.3 and show available target nodes
open_iscsi: show_nodes=yes discover=yes portal=10.1.2.3

discover targets on portal and login to the one available (only works if exactly one target is exported to the initiator)
open_iscsi: portal={{iscsi_target}} login=yes discover=yes

connect to the named target, after updating the local persistent database (cache)
open_iscsi: login=yes target=iqn.1986-03.com.sun:02:f8c1f9e0-c3ec-ec84-c9c9-8bfb0cd5de3d

discconnect from the cached named target
open_iscsi: login=no target=iqn.1986-03.com.sun:02:f8c1f9e0-c3ec-ec84-c9c9-8bfb0cd5de3d"

EXAMPLES
None

AUTHOR
Serge van Ginderachter

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#open-iscsi