Skip to content
iSCSI - HAC documentation hub

iSCSI

Enabling clustered iSCSI

Note

RSF-1 integrates with LIO subsystem to provide iSCSI targets/LUNs. Please ensure all relevant packages (i.e. targetcli-fb) are installed and enabled on all nodes in the cluster.

By default RSF-1 does not manage iSCSI shares - to enable clustered iSCSI management in RSF-1, navigate to Shares -> iSCSI and click ENABLE ISCSI SHARE HANDLING:

iscsi-enable-window

Note that any existing iSCSI configuration will be imported and displayed, otherwise an empty configuration will be shown:

iscsi-initial-window-no-targets

Existing configurations

  1. If any targets of an imported configuration uses the portal address of 0.0.0.0 to listen on, then LIO will block any other portal being created on addresses other than this.
    It is therefore important to either remove any IQN's with this portal address or modify the address with targetcli to use an IP other than 0.0.0.0
  2. Any targets not using a clustered pool/VIP combination will not be eligible for failover.

Clustering an iSCSI Share

RSF-1 supports two types of iSCSI share. A traditional approach where backing store (Zvol) is made available to clients through the use of a target IQN, accessed via a portal and controlled by ACL's. For this type of share an existing Zvol is required.

The second type of iSCSI share is specific to Proxmox, which has the ability to use an external ZFS based cluster as a storage backend for its virtual machines. This approach is known in Proxmox as ZFS over iSCSI and when configured correctly Proxmox is able to automate the process of creating a ZFS volume and then using that volume as an installation/boot disk for a virtual machine.

When creating a Proxmox share it is NOT necessary to specify the backing store, rather Proxmox will independantly manage it's own zvol's and LUNs within a pool. More information on configuring clustered iSCSI backed storage for Proxmox can be found here.

  1. Navigate to Shares -> iSCSI and click +ADD TARGET:

    iscsi-initial-window-no-targets

    The available options are:

    • IP Address - Select the VIP to add the portal of the share to
    • Port - The port to use for the portal
    • IQN (Optional) - Enter a custom IQN target name
    • Description (Optional) - Enter a description to help easily identify targets
  2. Select why type of share to create (in this example a traditional iSCSI share is being created):

    • iSCSI Share - Creates an iSCSI target with a Portal and LUN using a clustered Zvol
    • Proxmox Share - Creates an iSCSI target to be used with Proxmox and ZFS over iSCSI
  3. If creating an iSCSI share select the pool and zvol to use as the backing store.

  4. When done, click SUBMIT

The target will now be displayed in a collapsed form along with the description entered:

iscsi-target-list-one-member

Click the down arrow on the left hand side of a target to show details about that target:

iscsi-target-list-one-member-expanded

Optionally, restrict access to the target using ACL's. To add an ACL click the + ADD button, enter the remote initiator name and finally click the SUBMIT button:

iscsi-target-add-acl

As many ACL as required can be added to each target:

iscsi-target-list-one-member-expanded-with-acls

Combining iSCSI shares

The cluster supports the use of both types of iSCSI share simultaneously. The main difference being when Proxmox shares are first created they will have no LUN's configured: iscsi-target-add-acl

Deleting an iSCSI Share

To delete an iSCSI share click on the DELETE button next to the target and click CONFIRM:

iscsi-delete-popup