open_iscsi – Manage iSCSI targets with Open-iSCSI

From Get docs
Ansible/docs/2.8/modules/open iscsi module


open_iscsi – Manage iSCSI targets with 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

Parameter Choices/Defaults Comments

auto_node_startup

boolean

  • no
  • yes

Whether the target node should be automatically connected at startup.


aliases: automatic

discover

boolean

  • no
  • yes

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 configuration, like node.startup to manual, hence combined with auto_node_startup=yes will always return a changed state.

login

boolean

  • no
  • yes

Whether the target node should be connected.


aliases: state

node_auth

string

Default:

"CHAP"

The value for discovery.sendtargets.auth.authmethod.

node_pass

string

The value for discovery.sendtargets.auth.password.

node_user

string

The value for discovery.sendtargets.auth.username.

port

string

Default:

3260

The port on which the iSCSI target process listens.

portal

string

The IP address of the iSCSI target.


aliases: ip

show_nodes

boolean

  • no
  • yes

Whether the list of nodes in the persistent iSCSI database should be returned by the module.

target

string

The iSCSI target name.


aliases: name, targetname



Examples

- name: 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

# NOTE: Only works if exactly one target is exported to the initiator
- name: Discover targets on portal and login to the one available
  open_iscsi:
    portal: '{{ iscsi_target }}'
    login: yes
    discover: yes

- name: 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

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

Status

Authors

  • Serge van Ginderachter (@srvg)

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/open_iscsi_module.html