HP 3PAR Citrix Implementation Guide

5 Connecting a Host with Software iSCSI
Configuring Citrix 5.6 or 6.x for iSCSI
iSCSI on Citrix 5.6 or 6.x
iSCSI is installed by default by Citrix 5.6 or 6.x. The iscsiadm utility is a command-line tool that
allows discovery and login to iSCSI targets. This tool also provides access and management of
the open-iscsi database. The following steps are required to discover LUNs:
1. Discover targets at a given IP address.
2. Establish iSCSI login with the node record ID found during the target discovery process.
3. Record iSCSI session statistics information.
NOTE: HP 3PAR storage systems do not support hardware iSCSI with Citrix XenServer.
Setting Up iSCSI for Citrix 5.6 or 6.x
In Citrix 5.6 or 6.x, you must manually create the initiatorname.iscsi file under
/etc/iscsi.
1. Create the /etc/iscsi/initiatorname.iscsi file.
2. Add a line with theInitiatorName information:
InitiatorName= [InitiatorName from XenCenter]
For example:
InitiatorName=iqn.2011-10.com.3pardata:f8b6f263
You can adjust the iSCSI timers for better iSCSI session management and iSCSI I/O path
management. iSCSI timers and session parameters are specified in /etc/iscsi/iscsid.conf
file.
The replacement_timeout iSCSI timeout parameter prevents I/O errors from propagating to
the application by controlling how long the iSCSI layer should wait for a timed-out path/session
to reestablish itself before failing any commands on it. The default replacement_timeout value
is 120 seconds.
To adjust the iSCSI timers, complete the following steps:
1. Open /etc/iscsi/iscsid.conf and edit the following line to adjust
replacement_timeout:
node.session.timeo.replacement_timeout = [replacement_timeout]
2. Set this parameter to 15 seconds for a faster failover.
node.session.timeo.replacement_timeout = 15
NOTE: If the HP 3PAR StoreServ Storage array is running an HP 3PAR OS version earlier
than OS 3.1.3, set the replacement_timeout setting to 5 rather than 15.
26 Connecting a Host with Software iSCSI