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
:
Note that any existing iSCSI configuration will be imported and displayed, otherwise an empty configuration will be shown:
Existing configurations
- 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 withtargetcli
to use an IP other than 0.0.0.0 - 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.
-
Navigate to
Shares -> iSCSI
and click+ADD TARGET
:The available options are:
IP Address
- Select the VIP to add the portal of the share toPort
- The port to use for the portalIQN (Optional)
- Enter a custom IQN target nameDescription (Optional)
- Enter a description to help easily identify targets
-
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 ZvolProxmox Share
- Creates an iSCSI target to be used with Proxmox and ZFS over iSCSI
-
If creating an iSCSI share select the pool and zvol to use as the backing store.
-
When done, click
SUBMIT
The target will now be displayed in a collapsed form along with the description entered:
Click the down arrow on the left hand side of a target to show details about that target:
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:
As many ACL as required can be added to each target:
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:
Deleting an iSCSI Share
To delete an iSCSI share click on the DELETE
button next to the target and click CONFIRM
: