.. _iSCSI Workflow Overview:

iSCSI Workflow Overview
-----------------------

The typical workflow of exporting volumes via iSCSI is as follows:

#. Assign the network with the traffic type **iSCSI** to a network interface on each node that you will add to a target group. See :ref:`Managing Traffic Types and Networks`.

#. Create a target group on chosen nodes, providing details for target WWNs and portals. Targets will be created automatically and added to the group. Target portals will be created on specified network interfaces and ports. See :ref:`Creating Target Groups`.

#. Create volumes and attach them to the target group. See :ref:`Managing Volumes`.

#. Optionally, enable CHAP authorization for the target group, create CHAP accounts, and assign them to the target group. See :ref:`Managing CHAP Accounts`.

#. Optionally, enable ACL authorization for the target group, create a list of initiators that will be allowed to access only specific LUNs. Initiators not on the list will be able to access all LUNs in the target group. See :ref:`Managing LUN Views`.

#. Start the target group. See :ref:`Starting and Stopping Target Groups`.

#. Connect initiators to targets using standard tools of your operating system or product, e.g., ``iscsiadm``. Use the ``vstorage-target session-list`` command to view iSCSI sessions active on a node in a target group.

.. only:: ac

   .. _Managing Legacy iSCSI Targets:

   Managing Legacy iSCSI Targets
   *****************************

   After the upgrade to |product_name| 2.5, you can run older iSCSI targets created on version 2.4 alongside new targets. Older iSCSI targets can be detected by running ``vstorage-iscsi list`` and managed only using the ``vstorage-iscsi`` utility (see `Acronis Storage 2.4 Administrator's Command Line Guide <https://download.acronis.com/storage2/html/AcronisStorage_2_admins_cmd_guide_en-US/accessing-clusters-via-iscsi/index.html>`__).

   As older iSCSI targets do not support the ALUA mode, their LUNs are not highly available. To enable high availablity for them, detach a LUN from an older target with the command ``vstorage-iscsi lun-detach -t <target_IQN> -l <lun_ID>`` and attach it to a newly created target group as described in :ref:`Attaching iSCSI Volumes to Target Groups`.