open_iscsi - Manage iscsi targets with open-iscsi

Author:Serge van Ginderachter

Synopsis

New in version 1.4.

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

Options

parameter required default choices comments
auto_node_startup no
  • True
  • False
whether the target node should be automatically connected at startup
discover no
  • True
  • False
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.
login no
  • True
  • False
whether the target node should be connected
node_auth no CHAP
    discovery.sendtargets.auth.authmethod
    node_pass no
      discovery.sendtargets.auth.password
      node_user no
        discovery.sendtargets.auth.username
        port no 3260
          the port on which the iscsi target process listens
          portal no
            the ip address of the iscsi target
            show_nodes no
            • True
            • False
            whether the list of nodes in the persistent iscsi database should be returned by the module
            target no
              the iscsi target name

              Note

              Requires open_iscsi library and tools (iscsiadm)

              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"
              


              Table Of Contents

              Previous topic

              ohai - Returns inventory data from Ohai

              Next topic

              ping - Try to connect to host and return pong on success.