.. _Exporting Data via iSCSI:

Exporting Data via iSCSI
------------------------

.. include:: /includes/exporting-data-via-iscsi-part1.inc

.. _Creating iSCSI Targets:

Creating iSCSI Targets
~~~~~~~~~~~~~~~~~~~~~~

.. include:: /includes/exporting-data-via-iscsi-part2.inc

To create a target, do the following:

#. On the **SERVICES** > **iSCSI** > **Targets** screen, click **ADD TARGET**.

#. On the **Add target** panel, type a name for the new target in the **Name** field.

   .. image:: /images/stor_image35.png
      :align: center
      :class: align-center

#. In the node drop-down list, select a node on which the target will be located. The node should have an iSCSI role assigned to one of its network interfaces to appear in the list.

#. If necessary, check the **Enable CHAP** box and select an iSCSI user in the corresponding drop-down list (For more information on CHAP users, see :ref:`Managing iSCSI Users`).

#. Click **Add** to specify one or more IP addresses for the target.

#. If necessary, enable and specify IOPS and bandwidth limits for the target. If both limits are set, the first one that is hit is applied. Setting a limit value to zero disables the limit.

#. Click **Done** to create the target.

The ISCSI target will be automatically started after creation and the initiators will be able to access the target via the specified IP address.

.. _Performance Tips:

Performance Tips
****************

.. include:: /includes/exporting-data-via-iscsi-part3.inc

.. _Listing, Stopping, and Deleting iSCSI Targets:

Listing, Stopping, and Deleting iSCSI Targets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

On the iSCSI targets screen, you can list and manage all iSCSI targets and their LUNs, and display detailed information about specific iSCSI targets registered on a node.

To stop or delete an iSCSI target, select it on the iSCSI targets screen and click **Stop** or **Delete**, respectively. Doing so will disconnect the iSCSI initiator from the target. However, breaking the connection in such a way may result in I/O errors on the iSCSI initiator's side.

.. _Configuring iSCSI Targets:

Configuring iSCSI Targets
~~~~~~~~~~~~~~~~~~~~~~~~~

To configure an iSCSI target, do the following:

#. On the **SERVICES** > **iSCSI** > **Targets** screen, select the necessary target and click **Configure**.

#. On the **Configure** target screen, specify the necessary parameters.

   .. image:: /images/stor_image36.png
      :align: center
      :class: align-center

#. Click **Done**.

.. _Listing LUNs:

Listing LUNs
************

Each iSCSI target can have multiple LUNs (virtual disks or volumes). You can list the LUNs of a target and iSCSI initiators that are currently connected.

To list the LUNs, open the **SERVICES** > **iSCSI** > **Targets** screen, select a target and click a link in the **LUNs** column.

To list the initiators that are currently connected to iSCSI targets, open the **INITIATORS** tab on the same screen.

.. _Adding LUNs:

Adding LUNs
***********

To add a LUN to an iSCSI target, do the following:

#. On the **SERVICES** > **iSCSI** > **Targets** screen, select the necessary target and click a link in the **LUNs** column.

   .. image:: /images/stor_image37.png
      :align: center
      :class: align-center

#. To add a new LUN to the list, click **ADD LUN**.

   .. image:: /images/stor_image38.png
      :align: center
      :class: align-center

#. On the **Add LUN** screen, select the LUN's number from the drop-down list.

#. In the **LUN Size** field, specify the size of the LUN in GB; select a tier from the drop-down list to the right. For more information on tiers, see the `Installation Guide <https://download.acronis.com/storage2/html/AcronisStorage_2_installation_guide_en-US/planning-acronis-storage-infrastructure/understanding-storage-tiers.html>`__.

#. From the **Failure domain** drop-down list, choose a placement policy for replicas. For more details, see the `Installation Guide <https://download.acronis.com/storage2/html/AcronisStorage_2_installation_guide_en-US/planning-acronis-storage-infrastructure/understanding-failure-domains.html>`__.

#. Choose a data redundancy mode. For more details, see the `Installation Guide <https://download.acronis.com/storage2/html/AcronisStorage_2_installation_guide_en-US/planning-acronis-storage-infrastructure/understanding-data-redundancy.html>`__.

#. Click **Done**.

.. _Configuring LUNs:

Configuring LUNs
****************

To configure a LUN of an iSCSI target, do the following:

#. On the **SERVICES** > **iSCSI** > **Targets** screen, stop the target to which the LUN belongs.

#. Click a link in the target's **LUNs** column.

#. On the **Configure LUN** screen, specify the LUN size in the corresponding field.

#. Click **Done**.

.. _Deleting LUNs:

Deleting LUNs
*************

To delete a LUN, do the following:

#. On the **SERVICES** > **iSCSI** > **Targets** screen, select the necessary target and click a link in the **LUNs** column.

#. Select the necessary LUN in the list and click **Delete**.

.. _Managing iSCSI Users:

Managing iSCSI Users
~~~~~~~~~~~~~~~~~~~~

.. include:: /includes/exporting-data-via-iscsi-part4.inc

.. _Creating CHAP Accounts for iSCSI Targets:

Creating CHAP Accounts for iSCSI Targets
****************************************

To create a CHAP account, do the following:

#. On the **SERVICES** > **iSCSI Users** screen, click **Add user**.

#. Specify login, password, and, if necessary, a description for the account. The password should be 12 to 16 characters long for Windows clients to be able to establish connections.

   .. image:: /images/stor_image39.png
      :align: center
      :class: align-center

#. Click **Done**.

The newly created CHAP user account will be listed on the **iSCSI Users** screen.

.. _Creating iSCSI Targets Bound to CHAP Accounts:

Creating iSCSI Targets Bound to CHAP Accounts
*********************************************

To create an iSCSI target bound to a CHAP account, do the following:

#. On the **SERVICES** > **iSCSI** > **Targets** screen, select an iSCSI target and click **Configure**.

#. On the **Configure** target screen, check **Enable CHAP** and/or **Enable mutual CHAP** and select users in the corresponding drop-down lists. If you enable CHAP, the target will authenticate the initiator. If you enable mutual CHAP, the initiator will authenticate the target. These options can be enabled in any combination.

   .. image:: /images/stor_image40.png
      :align: center
      :class: align-center

#. Click **Done**.

.. _Changing CHAP Account Passwords:

Changing CHAP Account Passwords
*******************************

To change the password of a CHAP account, do the following:

#. On the **SERVICES** > **iSCSI Users** screen, select a user and click **Configure**.

#. In the **Password** section on the **Configure** user screen, click change.

   .. image:: /images/stor_image41.png
      :align: center
      :class: align-center

#. Type a new password in the corresponding field and click **Done**. The password should be 12 to 16 characters long for Windows clients to be able to establish connection.

The new password will become active after target reboot.