HP ProLiant Accelerated iSCSI for Linux User Guide Part Number 538529-001 March 2009 (First Edition)
© Copyright 2007, 2009 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Confidential computer software.
Contents Overview..................................................................................................................................... 4 iSCSI protocol........................................................................................................................................... 4 Supported operating systems ...................................................................................................................... 4 Supported hardware...................................
Overview iSCSI protocol The HP iSCSI protocol transports block-level storage requests of TCP connections over IPv4 and IPv6. Using the iSCSI protocol, systems can connect to remote storage and use it as a physical disk although the remote storage provider or target may actually be providing virtual physical disks. HP Accelerated iSCSI supports all targets that are certified and supported by Linux software.
• HP NC382T PCI Express Dual Port Multifunction Gigabit Server Adapter • HP NC382m Dual Port 1GbE Multifunction BL-c Adapter • HP NC382i Integrated Quad Port PCI Express Gigabit Server Adapter • HP NC532m Dual Port Flex-10 10GbE Multifunction BL-c Adapter • HP NC532i Dual Port 10GbE Multifunction BL-c Adapter* * Requires an HP ProLiant Accelerated iSCSI license to enable acceleration iSCSI targets. All iSCSI targets supported by the Linux software initiator are supported by HP.
Installation and configuration Downloading files 1. Go to the HP website (http://www.hp.com/#Support). 2. Select Download drivers and software (and firmware). 3. Type the adapter name in the For product box, and then click Go. For example, NC382T. 4. Select an operating system. 5. Click HP NC-Series iSCSI Offload Driver for Linux. 6. Click download and save the HP SoftPaq (sp#####.exe) file to a directory on your hard drive.
If an old version of the package exists, the RPM package should be removed. # rpm -e netxtreme2 5. Verify that the old netxtreme2 package has been removed as follows: # rpm -q netxtreme2 6. Verify if a old version of bnx2 or bnx2x is loaded into the kernel and remove it, if needed, as follows: If you are installing the package over the network, it is not necessary to remove the modules.
1. To install the source RPM package, change to the linux\iscsi-offload directory on your hard drive and use the following command: # rpm -ivh bnx2i-.src.rpm 2. Build the binary RPM for the bnx2i driver. For Red Hat EL 5 installations enter the following commands: # cd /usr/src/redhat # rpmbuild -bb SPECS/bnx2i.spec For SLES installations enter the following commands: # cd /usr/src/packages # rpmbuild -bb SPECS/bnx2i.spec 3.
Most systems are set to level 6 by default. To include debug-level messages, set the level to 7. The following sample messages are the most common bnx2i driver messages that may be logged in the file /var/log/messages. • bnx2i driver signon Broadcom NetXtreme II iSCSI Driver bnx2i v1.0.
bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: bnx2i: • iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error iscsi_error - ERL0, U3 E
Red Hat Installing the license key To install the license key on Red Hat Enterprise Linux systems, 1. Navigate to the \linux\hp-pel\hp-pel-.rhel5.linux.rpm file. 2. Use the following command to install the HP ProLiant Licensing RPM: rpm -Uvh hp-pel-.rhel5.linux.rpm 3. Add the license key using the following command: /opt/hp/hp-pel/nalicense -a license_string If you have an old license and want to add a new license, just add the new license. You cannot delete the old license. 4.
/opt/hp/hp-pel/nalicense -d [-l ] Include the -l parameter if you want all the information that normally prints to stdout to be redirected to the file specified with . Installing the port-based license utility To install the HP Linux iSCSI Offload Utility on SUSE Linux Enterprise Server systems, 1. Navigate to the \linux\hp-pbl\hp-pbl-.sles10.linux.rpm file. 2. Use the following command to install the utility: rpm -Uvh hp-pbl-..linux.rpm 3.
WARNING indicates a warning such as too many MACs configured for iSCSI offload. INFO indicates an informative event such as hp-pbl starting and stopping. SP is one or more spaces. DATE is the current date stamp in the format Sat Feb 17 12:54:35 CST 2007. TEXT is free form text that may or may not exist in every message. Lines that do not start with a tag are a continuation of the previous line. The following represent sample text lines. [INFO] [Thu Feb 10 10:34:15 CST 2007] hp-pbl started - v1.0.0-1.
Uninstalling the license for HP port-based Linux iSCSI offload To uninstall the licensing for HP port-based Linux iSCSI offload utility, remove the HP ProLiant licensing RPM and the Linux iSCSI offload utility package. Removing the HP ProLiant Licensing RPM The database containing ProLiant licenses is deleted if the HP ProLiant Licensing RPM package is removed. Make sure your hard-copy ProLiant packaging license strings are available before removing this package.
If an older version of the package exists, remove the older iscsi-initiator-utils RPM package using the following command: # rpm -e iscsi-initiator-utils Verify that the old package has been removed using the following command: # rpm -q iscsi-initiator-utils 5. Install the iscsi-initiator-utils binary RPM package using the following command: # rpm -ivh RPMS//iscsi-initiator-utils-..rpm 6. Start the iscsi daemon using the following command: #/etc/init.
Loading the Linux iSCSI offload bnx2i module After installing the Linux iSCSI Offload bnx2i driver and the iSCSI Offload Initiator utilities for Red Hat or SLES, use the following command to load the Linux iSCSI Offload bnx2i module: # modprobe bnx2i Executing the bnx2id application After the Linux iSCSI offload bnx2i RPM package is installed, the bnx2id application is installed under /sbin. The driver cannot establish an iSCSI connection until the bnx2id application is executed.
Binding the iSCSI target Changing the transport binding of the iSCSI node By default the open-iscsi daemon connects to discovered targets using the software initiator with transport name = tcp. To offload iSCSI connections, you must change the transport binding of the iSCSI node by completing the following steps. 1. Discover targets at a specified IP address using the following command: # iscsiadm --mode discovery --type sendtargets --portal 2. Obtain the
Connecting to the iSCSI target Sample commands to discover targets and create iSCSI connections • Add static entry # iscsiadm -m node -p -T -o new • iSCSI target discovery using 'SendTargets' # iscsiadm -m discovery --type sendtargets -p • Login to target using 'iscsiadm' command iscsiadm --mode node --targetname
Acronyms and abbreviations HBA host bus adapter iSCSI Internet Small Computer System Interface RPM Red Hat Package Manager SLES SUSE Linux Enterprise Server Acronyms and abbreviations 19
Index A offload status 12 overview 4 adapters supported 4 S B status, offload 12 supported hardware 4 supported operating systems 4 Binding the iSCSI target 17 bnx2 driver 6 bnx2i driver 7, 15 bnx2id application 15 C T targets, discovering 17 troubleshooting 13 Connecting to the iSCSI target 18 U D uninstalling 8, 14, 15 discovering targets 18 downloading files 6 E Executing the bnx2id application 16 H HP NC-Series iSCSI offload initiator utilities 14, 15 HP ProLiant Licensing 11, 12, 14 I i
