User guide

User Guide NetXtreme II
September 2013
Broadcom Corporation
Document INGSRVT78-CDUM100-R Linux iSCSI Offload Page 163
LINUX ISCSI OFFLOAD
• Open iSCSI User Applications
• User Application - brcm_iscsiuio
• Bind iSCSI Target to Broadcom NX2 iSCSI Transport Name
• Making Connections to iSCSI Targets
• Maximum Offload iSCSI Connections
• Linux iSCSI Offload FAQ
OPEN ISCSI USER APPLICATIONS
Install and run the inbox open-iscsi initiator programs from the DVD. Refer to Packaging for details.
USER APPLICATION - BRCM_ISCSIUIO
Install and run the brcm_iscsiuio daemon before attempting to create iSCSI connections. The driver will not be able to
establish connections to the iSCSI target without the daemon's assistance.
1. Install the brcm_iscsiuio source package
# tar -xvzf iscsiuio-<version>.tar.gz
2. CD to the directory where iscsiuio is extracted
# cd iscsiuio-<version>
3. Compile and install
# ./configure
# make
# make install
4. Check the iscsiuio version matches with the source package
# brcm_iscsiuio -v
5. Start brcm_iscsiuio
# brcm_iscsiuio
BIND ISCSI TARGET TO BROADCOM NX2 ISCSI TRANSPORT NAME
By default, the open-iscsi daemon connects to discovered targets using software initiator (transport name = 'tcp'). Users who
wish to offload iSCSI connection onto CNIC device should explicitly change transport binding of the iSCSI iface. This can be
done using the iscsiadm CLI utility as follows,
iscsiadm -m iface -I <iface_file_name> -n iface.transport_name -v bnx2i -o update
where the iface file includes the following information for RHEL 5.4, RHEL 5.5, and SLES 11 SP1:
iface.net_ifacename = ethX
iface.iscsi_ifacename = <name of the iface file>
iface.hwaddress = XX:XX:XX:XX:XX:XX
iface.ipaddress = XX.XX.XX.XX
iface.transport_name = bnx2i
Ensure that the iface.hwaddress is in lower case format.