HP NC373m - PCI Express Dual Port Multifunction Gigabit Server... User manual

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. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212,
Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S.
Government under vendor’s standard commercial license.
Intended audience
This document is for the person who installs, administers, and troubleshoots servers and storage systems.
HP assumes you are qualified in the servicing of computer equipment and trained in recognizing hazards
in products with hazardous energy levels.

Contents 3
Contents
Overview..................................................................................................................................... 4
iSCSI protocol........................................................................................................................................... 4
Supported operating systems ...................................................................................................................... 4
Supported hardware.................................................................................................................................. 4
Installation and configuration ......................................................................................................... 6
Downloading files ..................................................................................................................................... 6
Installing the BRCM Multifunction drivers for Linux ......................................................................................... 6
Installing the Linux iSCSI offload bnx2i driver................................................................................................ 7
Linux iSCSI offload bnx2i driver limitations ......................................................................................... 8
Uninstalling the HP Linux iSCSI offload bnx2i driver RPM package ........................................................ 8
Linux iSCSI offload bnx2i driver messages.................................................................................................... 8
Installing the license for embedded adapters............................................................................................... 10
Red Hat........................................................................................................................................ 11
SLES ............................................................................................................................................ 11
Reporting iSCSI Offload status ........................................................................................................ 12
HP ProLiant Licensing Log and Event File........................................................................................... 12
Troubleshoot known issues for HP port-based Linux iSCSI offload......................................................... 13
Uninstalling the license for HP port-based Linux iSCSI offload........................................................................ 14
Removing the HP ProLiant Licensing RPM ..........................................................................................14
Removing the hp-pbl RPM package.................................................................................................. 14
HP NC-Series iSCSI offload initiator utilities ................................................................................................ 14
Red Hat........................................................................................................................................ 14
SLES ............................................................................................................................................ 15
Loading the Linux iSCSI offload bnx2i module............................................................................................. 16
Executing the bnx2id application .............................................................................................................. 16
Binding the iSCSI target............................................................................................................... 17
Changing the transport binding of the iSCSI node ....................................................................................... 17
Connecting to the iSCSI target...................................................................................................... 18
Sample commands to discover targets and create iSCSI connections.............................................................. 18
Acronyms and abbreviations........................................................................................................ 19
Index......................................................................................................................................... 20

Overview 4
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 Gigabit Ethernet Multifunction Server Adapters can be enabled as iSCSI devices or virtual iSCSI host
bus adapters (HBAs), a feature commonly referred to as accelerated iSCSI. iSCSI HBAs or accelerated
adapters, provide the capability to run iSCSI protocol over offloaded TCP connections. By offloading the
IPv4 or IPv6 TCP connection processing to an HP Gigabit Ethernet Multifunction Server Adapter, CPU
utilization is reduced allowing additional processing capacity for applications. The HP accelerated iSCSI
solution supports all targets that are certified and supported by Linux software.
Supported operating systems
•Red Hat Enterprise Linux 5 AS/ES for AMD64/EM64T
•Red Hat Enterprise Linux 5 AS/ES for x86
•SUSE LINUX Enterprise Server 10 (SP1, SP2) for x86
•SUSE LINUX Enterprise Server 10 (SP1, SP2) for AMD64
Supported hardware
Servers. Server support includes all ProLiant servers that include an iLO or RiLO management device with
any of the supported operating systems.
Adapters. HP adapter support includes the following:
•HP NC370T PCI-X Multifunction Gigabit Server Adapter
•HP NC370F PCI-X Multifunction Gigabit Server Adapter
•HP NC370i PCI-X Multifunction Gigabit Server Adapter *
•HP NC371i PCI-X Multifunction Gigabit Server Adapter*
•HP NC373F PCI Express Multifunction Gigabit Server Adapter
•HP NC373T PCI Express Multifunction Gigabit Server Adapter
•HP NC373m PCI Express Dual Port Multifunction Gigabit Server Adapter for c-Class BladeSystem
•HP NC373i Integrated Multifunction Gigabit Server Adapter*
•HP NC374m PCI Express Dual Port Multifunction Gigabit Server Adapter
•HP NC380T PCI Express Dual Port Multifunction Gigabit Server Adapter

Overview 5
•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 6
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. The
SoftPaq file is a self-extracting executable with a file name based on the SoftPaq number.
7. Click the SoftPaq file to extract the files.
Installing the BRCM Multifunction drivers for Linux
The HP NC-Series Broadcom Multifunction Drivers for Linux are released in a source RPM format and the
file name for the package is netxtreme2-<version>.sri.rpm. The package contains the source code and
build instructions for bnx2, bnx2x, and cnic drivers.
1. Build Environment Setup. The netxtreme2 package requires the presence of packages that provide
the right build environment. These packages provide kernel headers, makefiles, and symbol files
(suggested only on SLES distributions).
Red Hat installations:
For each kernel flavor you want to build the driver make sure you have the associated kernel-devel
package. For example, kernel-2.6.18.92.el5 requires kernel-devel-2.6.18-92.el5 and kernel-PAE-
2.6.18.92.el5 requires kernel-PAE-devel-2.6.18-92.el5.
SUSE SLES installations:
Make sure that kernel-source and kernel-syms packages are installed. The kernel-syms package
contains symbol versions for all of the iterations that the distribution supports.
2. Install the source RPM package.
# rpm -ivh netxtreme2-<version>.src.rpm
3. Build the binary RPM for the netxtreme2.
Red Hat installations:
# cd /usr/src/redhat
# rpmbuild -bb SPECS/netxtreme2.spec
SLES installations:
# cd /usr/src/packages
# rpmbuild -bb SPECS/netxtreme2.spec
If you get an error during the build process, go back to step one above.
4. Check for the existence of a current version of the netxtreme2 package as follows:
# rpm -q netxtreme2

Installation and configuration 7
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. This
step is only necessary if you are doing the upgrade on the physical console and you want the new
drivers to take over immediately.
#lsmod | grep bnx2x
#lsmod | grep bnx2
7. Before removing the drivers, bring down the interfaces controlled by bnx2x and bnx2.
#ifconfig eth<n> down
8. Remove the drivers.
#rmmod bnx2x
#rmmod bnx2
9. Install the new RPM package. This installs bnx2/bnx2x and cnic drivers. Do not use the U (Upgrade)
flag in the RPM command below--previous netxtreme2 packages must be removed as described
above before installing this version.
#rpm -ivh RPMS/<arch>/netxtreme2-<version>.<arch>.rpm
The bnx2.ko, bnx2x.ko and cnic.ko modules are installed in the following directory:
Red Hat EL 4/5 installations:
/lib/modules/<kernel_version>/updates
SLES 9/10 installations:
/lib/modules/<kernel_version>/updates
10. Configure your network setting and address. See your Linux vendor documentation for more
information. Helpful network configuration tools such as "yast2" in SLES or linuxconf/redhat-config-
network/netconfig in Red Hat exist for easy configuration.
11. Ensure that the /etc/modules.conf file is configured similar to the example listed below. The example
below is presented as if more than one adapter is present. If so, one eth# instance should exist for
each ethernet port. See the modules.conf man page for more information.
If you have a 1Gb Network card use bnx2 below otherwise use bnx2x for 10Gb.
alias eth0 bnx2
alias eth1 bnx2
For SLES, the configuration file is /etc/modprobe.conf or /etc/modprobe.conf.local
12. You can now reboot your server or restart the network services. Upon reboot the network should start
with either bnx2 or bnx2x driver loaded.
To verify that the driver is loaded use the following command.
# lsmod
You should find bnx2 or bnx2x listed. You can also verify that the correct bnx2 or bnx2x driver is
loaded through any of the following methods. Note that version of the driver loaded should be same
as that of the package version.
Installing the Linux iSCSI offload bnx2i driver
The Linux iSCSI offload bnx2i driver is released in a source RPM format.

Installation and configuration 8
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-<version>.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. Check for the existence of a current version of the bnx2i package using the following command:
# rpm -q bnx2i
If an older version of the package exists, remove the old RPM package using the following
command:
# rpm -e bnx2i
Remove the loaded bnx2i module using the following command:
# modprobe -r bnx2i
This command removes the bnx2i module along with its dependencies.
Verify that the old bnx2i package has been removed using the following command:
# rpm -q bnx2i
4. Install the bnx2i binary RPM package using the following command:
# rpm -ivh RPMS/<arch>/bnx2i-<version>.<arch>.rpm
The bnx2i.ko module is installed in the following directory:
/lib/modules/<kernel_version>/kernel/drivers/iscsi
Linux iSCSI offload bnx2i driver limitations
•The current version of the driver has been tested on 2.6.x kernels beginning with the 2.6.18 kernel.
The driver may not compile on kernels older than the 2.6.18 kernel. SLES10 SP1 is an exception. It
also runs on the 2.6.16.46 kernel because SUSE upgraded the iscsi_transport kernel module to
support offload initiators in SLES10 SP1.
•When installing SLES 10 SP2 select to enable IPv6 so that autoload is enabled for the IPv6 kernel
module. The cnic driver which is delivered in the NetXtreme2 RPM and is required for iSCSI offload
will fail to resolve symbols if IPv6 is disabled because it has a dependancy on the IPv6 module.
Uninstalling the HP Linux iSCSI offload bnx2i driver RPM
package
If you need to uninstall the HP bnx2 RPM, use the following command:
# rpm -e bnx2i-<version>
Linux iSCSI offload bnx2i driver messages
Linux iSCSI offload bnx2i driver messages are logged in the file /var/log/messages.
Use the following command to control the level that messages appear on the console:
dmesg -n <level>

Installation and configuration 9
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.30 (Sep 29, 2007)
•Network port to iSCSI transport name binding
bnx2i: netif=eth2, iscsi=bcm5708-050000
bnx2i: netif=eth1, iscsi=bcm5706-030c00
•Driver completes handshake with iSCSI offload enabled CNIC device
bnx2i [05:00.00]: ISCSI_INIT passed
This message displays only when a user attempts to make an iSCSI connection.
•Driver detects iSCSI Offload is not enabled on the CNIC device
bnx2i: iSCSI not supported, dev=eth3
bnx2i: bnx2i: LOM is not enabled to offload iSCSI connections, dev=eth0
•Driver unable to allocate TCP port for iSCSI connection
bnx2i: run 'bnx2id' daemon to alloc TCP ports
•Exceeds maximum allowed iSCSI connection offload limit
bnx2i: unable to allocate iSCSI context resources
•Network route to target node and transport name binding are 2 different devices
bnx2i: conn bind, ep=0x... ($ROUTE_HBA) does not belong to hba
$USER_CHOSEN_HBA
where ROUTE_HBA --> net device on which connection was offloaded based
on route information
USER_CHOSEN_HBA --> HBA to which target node is bound (using iSCSI
transport name)
•Target cannot be reached on any of CNIC devices
bnx2i: check route, can't connect using cnic
•Network route is assigned to network interface that is down
bnx2i: check route, hba not found
•Attempting to offload iSCSI connection onto Jumbo frame enabled device
bnx2i: eth# network i/f mtu is set to #mtu
bnx2i: iSCSI HBA can support mtu of 1500
The user must change mtu to < 1500 using ethtool and restart the interface to offload iSCSI
connections.
•SCSI-ML initiated host reset (session recovery)
bnx2i: attempting to reset host, #3
•CNIC detects iSCSI protocol violation — FATAL errors
bnx2i: iscsi_error - wrong StatSN rcvd
bnx2i: iscsi_error - hdr digest err
bnx2i: iscsi_error - data digest err
bnx2i: iscsi_error - wrong opcode rcvd
bnx2i: iscsi_error - AHS len > 0 rcvd
bnx2i: iscsi_error - invalid ITT rcvd
bnx2i: iscsi_error - wrong StatSN rcvd
bnx2i: iscsi_error - wrong DataSN rcvd
bnx2i: iscsi_error - pend R2T violation
bnx2i: iscsi_error - ERL0, UO
bnx2i: iscsi_error - ERL0, U1
bnx2i: iscsi_error - ERL0, U2

Installation and configuration 10
bnx2i: iscsi_error - ERL0, U3
bnx2i: iscsi_error - ERL0, U4
bnx2i: iscsi_error - ERL0, U5
bnx2i: iscsi_error - ERL0, U
bnx2i: iscsi_error - invalid resi len
bnx2i: iscsi_error - MRDSL violation
bnx2i: iscsi_error - F-bit not set
bnx2i: iscsi_error - invalid TTT
bnx2i: iscsi_error - invalid DataSN
bnx2i: iscsi_error - burst len violation
bnx2i: iscsi_error - buf offset violation
bnx2i: iscsi_error - invalid LUN field
bnx2i: iscsi_error - invalid R2TSN field
bnx2i: iscsi_error - invalid cmd len1
bnx2i: iscsi_error - invalid cmd len2
bnx2i: iscsi_error - pend r2t exceeds MaxOutstandingR2T value
bnx2i: iscsi_error - TTT is rsvd
bnx2i: iscsi_error - MBL violation
bnx2i: iscsi_error - data seg len != 0
bnx2i: iscsi_error - reject pdu len error
bnx2i: iscsi_error - async pdu len error
bnx2i: iscsi_error - nopin pdu len error
bnx2i: iscsi_error - pend r2t in cleanup
bnx2i: iscsi_error - IP fragments rcvd
bnx2i: iscsi_error - IP options error
bnx2i: iscsi_error - urgent flag error
•CNIC detects iSCSI protocol violation — non-FATAL, warning
bnx2i: iscsi_warning - invalid TTT
bnx2i: iscsi_warning - invalid DataSN
bnx2i: iscsi_warning - invalid LUN field
The driver must be configured for some violations to be reported as a warning instead of as a critical
error.
•Driver puts a session through recovery
conn_err - hostno 3 conn 03fbcd00, iscsi_cid 2 cid a1800
•REJECT iSCSI PDU received from the target
bnx2i - printing rejected PDU contents
[0]: 1 ffffffa1 0 0 0 0 20 0
[8]: 0 7 0 0 0 0 0 0
[10]: 0 0 40 24 0 0 ffffff80 0
[18]: 0 0 3 ffffff88 0 0 3 4b
[20]: 2a 0 0 2 ffffffc8 14 0 0
[28]: 40 0 0 0 0 0 0 0
•Open-iSCSI daemon handing over session to driver
bnx2i: conn update - MBL 0x800 FBL 0x800MRDSL_I 0x800 MRDSL_T 0x2000
Installing the license for embedded adapters
The HP Accelerated iSCSI capability for Linux systems is available as a licensable feature for most
embedded HP Multifunction Gigabit Server Adapters through the purchase of an HP ProLiant Accelerated
iSCSI port-based license. License keys are installed on a per-port basis for each embedded adapter. See
the list of supported adapters to see if your adapter requires a license.
This license is not required for standup and mezzanine HP Multifunction Gigabit Server Adapters and HP
Multifunction Gigabit Server Adapters for HP BladeSystem servers.

Installation and configuration 11
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-<version>.rhel5.linux.rpm file.
2. Use the following command to install the HP ProLiant Licensing RPM:
rpm -Uvh hp-pel-<version>.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. Check the status of all currently installed licenses on the system using the following command:
/opt/hp/hp-pel/nalicense -d [-l <logfile>]
Include the -l parameter if you want all the information that normally prints to stdout to be redirected
to the file specified with <logfile>.
Installing the port-based license utility
To install the port-based Linux iSCSI Offload Utility on Red Hat Enterprise Linux systems,
1. Navigate to the \linux\hp-pbl\hp-pbl-<version>.rhel5.linux.rpm file.
2. Use the following command to install the utility:
rpm -Uvh hp-pbl-<version>.rhel5.linux.rpm
3. The hp-pbl utility is configured to start on system boot-up; however, you can start it immediately after
installation without rebooting using the following command:
/etc/init.d/hp-pbl start
4. The hp-pbl configuration file is a text file located at etc/opt/hp/hp-pbl/hp-pbl.conf. The format of
the configurable MAC parameter is documented in the hp-pbl.conf file. If changes are made to the
hp-pbl.conf configuration file, you must restart hp-pbl using the following command:
/etc/init.d/hp-pbl restart
5. To manually stop the hp-pbl daemon, use the following command:
/etc/init.d/hp-pbl stop
SLES
Installing the license key
To install the license key on SUSE Linux Enterprise Server systems,
1. Navigate to the \linux\hp-pel\hp-pel-<version>.sles10.linux.rpm file.
2. Use the following command to install the HP ProLiant Licensing RPM:
rpm -Uvh hp-pel-<version>.sles10.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. Check the status of all currently installed licenses on the system using the following command:

Installation and configuration 12
/opt/hp/hp-pel/nalicense -d [-l <logfile>]
Include the -l parameter if you want all the information that normally prints to stdout to be redirected
to the file specified with <logfile>.
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-<version>.sles10.linux.rpm file.
2. Use the following command to install the utility:
rpm -Uvh hp-pbl-<version>.<distro>.linux.rpm
3. The hp-pbl utility is configured to start on system boot-up; however, you can start it immediately after
installation without rebooting using the following command:
/etc/init.d/hp-pbl start
4. The hp-pbl configuration file is a text file located at etc/opt/hp/hp-pbl/hp-pbl.conf. The format of
the configurable MAC parameter is documented in the hp-pbl.conf file. If changes are made to the
hp-pbl.conf configuration file, you must restart hp-pbl using the following command:
/etc/init.d/hp-pbl restart
5. To manually stop the hp-pbl daemon, use the following command:
/etc/init.d/hp-pbl stop
Reporting iSCSI Offload status
To obtain the iSCSI offload status of embedded adapters, use the following command:
/etc/init.d/hp-pbl status
Output example
iSCSI offload licenses available: 4
iSCSI licenses used: 1
LOM Configured Enabled
00:19:BB:3C:A0:1C YES YES
Where:
oiSCSI licenses available reports the number of iSCSI offload licenses available.
oiSCSI licenses used reports the number of iSCSI offload licenses enabled.
oLOM is the iSCSI capable LOM MACs. If the MAC is not an iSCSI capable LOM, it is not
displayed with the status command. Error messages are entered in the hp-pbl.log file.
oConfigured reports YES when the iSCSI capable LOM MAC is entered in the hp-p bl.conf file
and is reported as NO if it was not entered in the hp-pbl.conf file. An error message is entered in
the hp-pbl.log file if the iSCSI capable LOM MAC is not entered correctly in the hp-pbl.conf file.
oEnabled reports YES when the iSCSI capable LOM MAC is currently enabled for iSCSI offload
and reports NO when it is not enabled.
HP ProLiant Licensing Log and Event File
All messages are logged to /var/opt/hp/hp-pbl/hp-pbl.log.
Log messages are in the following format:
[TAG] SP [DATE] SP TEXT TAG
Where TAG is one of:
ERROR indicates an error such as a missing hp-pbl.conf file.

Installation and configuration 13
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.rhel5
[INFO] [Thu Feb 10 12:54:36 CST 2007]
first text line of second info message
second text line of second info message
Troubleshoot known issues for HP port-based Linux iSCSI offload
Complete the following steps to troubleshoot the hp-pbl licensing.
1. Run the following command in a separate window to monitor the hp-pbl.log file for messages.
tail -f /var/opt/hp/hp-pbl/hp-pbl.log
2. Run the following command in a separate window to monitor the messages file.
tail -f /var/log/messages
Potential problems, causes and solutions
Problem:
Does not appear to create an iSCSI offloaded connection when configured for offload.
Possible cause:
The initiator needs to be restarted after the transport name is changed for offload, and the bnx2i driver
needs to be reloaded so that the configuration changes are realized. Both of these events occur when hp-
pbl is restarted.
Possible solution:
Run the following command to restart hp-pbl:
/opt/hp/hp-pbl restart
Problem:
Does not appear to create an iSCSI offloaded connection when configured for offload and
/var/log/messages lists the following information:
bnx2i: conn bind, ep=0x... ($ROUTE_HBA) does not belong to hba
$USER_CHOSEN_HBA
Possible cause:
A potential problem with the link layer address to IP address mapping occurs when a server with multiple
network cards is connected to the same network segment. This issue is commonly known as the Arp Flux
Problem.
Possible solution:
Set up the network so that network cards are on separate network segments or broadcast domains.

Installation and configuration 14
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.
You can obtain the license strings by displaying all licenses on the system using the check the status of all
currently installed licenses on the system command:
/opt/hp/hp-pel/nalicense -d [-l <logfile>]
Include the -l parameter if you want all the information that normally prints to stdout to be redirected
to the file specified with <logfile>.
Record the license strings and keep them for reference.
To remove the HP PEL package, run the following command:
rpm -e hp-pel
Removing the hp-pbl RPM package
Remove the hp-pbl RPM package using the following command:
rpm -e hp-pbl
HP NC-Series iSCSI offload initiator utilities
The HP NC-Series iSCSI Offload Initiator Utilities for Red Hat and SLES are released in a source RPM
format.
Red Hat
Install HP NC-Series iSCSI Offload Initiator Utility for RH
Install the HP NC-Series iSCSI Offload Initiator Utilities for Red Hat RPM package:
1. Change to the linux\iscsi-offload directory on your hard drive and use the following command:
# rpm -ivh iscsi-initiator-utils-<version>.src.rpm
2. Build the binary RPM for the open-iSCSI initiator utility using the following commands:
# cd /usr/src/redhat
# rpmbuild -bb SPECS/iscsi-initiator-utils.spec
3. Stop the iscsid daemon using the following command:
#/etc/init.d/iscsid stop
4. Check for the existence of a current version of the iscsi-initiator-utils package using the following
command:
# rpm -q iscsi-initiator-utils

Installation and configuration 15
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/<arch>/iscsi-initiator-utils-<version>.<arch>.rpm
6. Start the iscsi daemon using the following command:
#/etc/init.d/iscsi start
Uninstalling the HP NC-Series iSCSI offload initiator utilities for Red Hat
If you need to uninstall the HP NC-Series iSCSI offload initiator utilities for Red Hat, use the following
command:
# rpm -e iscsi-initiator-utils-<version>
SLES
Install HP NC-Series iSCSI Offload Initiator Utility for SLES
Install the HP NC-Series iSCSI Offload Initiator Utilities for SLES RPM package:
1. Change to the linux\iscsi-offload directory on your hard drive and use the following command:
# rpm -ivh open-iscsi-<version>.src.rpm
2. Build the binary RPM for the open-iSCSI initiator utility using the following commands:
# cd /usr/src/redhat
# rpmbuild -bb SPECS/open-iscsi.spec
3. Stop the iscsid daemon using the following command:
#/etc/init.d/open-iscsi stop
4. Check for the existence of a current version of the open-iscsi initiator utilities package using the
following command:
# rpm -q open-iscsi
If an older version of the package exists, remove the older open-iscsi initiator utilities RPM package
using the following command:
# rpm -e open-iscsi
Verify that the old package has been removed using the following command:
# rpm -q open-iscsi
5. Install the open-iscsi binary RPM package using the following command:
# rpm -ivh RPMS/<arch>/open-iscsi-<version>.<arch>.rpm
6. Start the open-iscsi daemon using the following command:
#/etc/init.d/open-iscsi start
Uninstalling the HP NC-Series iSCSI offload initiator utilities for SLES
If you need to uninstall the HP NC-Series iSCSI Offload Initiator Utilities for SLES RPM, use the following
command:
# rpm -e open-iscsi-<version>

Installation and configuration 16
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.
Execute the bnx2id application using the following command:
# bnx2id

Binding the iSCSI target 17
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 <ipaddr[:port]>
2. Obtain the <iqn.targetname> from step 1 and bind the transport name with the following command:
# iscsiadm --mode node --targetname <iqn.targetname> --portal
<ipaddr[:port]> \ --op=update --name=node.transport_name --
value=<XPORT_NAME>
Please note that the [:port] argument is not needed for IPv6 addresses.
Execute the following command to obtain the iSCSI transport name binding:
# dmesg | grep "bnx2i: netif"
The following is a sample output of a system with 2 NetXtreme II devices:
bnx2i: netif=eth1, iscsi=bcm570x-05000
bnx2i: netif=eth0, iscsi=bcm570x-03000

Connecting to the iSCSI target 18
Connecting to the iSCSI target
Sample commands to discover targets and create
iSCSI connections
•Add static entry
# iscsiadm -m node -p <ipaddr[:port,TPGT]> -T <iqn.targetname> -o new
•iSCSI target discovery using 'SendTargets'
# iscsiadm -m discovery --type sendtargets -p <ipaddr[:port]>
•Login to target using 'iscsiadm' command
iscsiadm --mode node --targetname <iqn.targetname> --portal
<ipaddr[:port]> --login
•List all drives active in the system
# 'fdisk -l'
See the open-iSCSI documentation for comprehensive list of iscsiadm commands.

Acronyms and abbreviations 19
Acronyms and abbreviations
HBA
host bus adapter
iSCSI
Internet Small Computer System Interface
RPM
Red Hat Package Manager
SLES
SUSE Linux Enterprise Server

Index 20
A
adapters supported 4
B
Binding the iSCSI target 17
bnx2 driver 6
bnx2i driver 7, 15
bnx2id application 15
C
Connecting to the iSCSI target 18
D
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
installation and configuration 6
installing bnx2, bnx2i, and bnx2x drivers 6, 7
Installing the Linx iSCSI offload bnx2i driver 7
iSCSI connections 18
iSCSI targets 17, 18
L
license 11, 12, 14
license key, installing 11
Linux iSCSI offload bnx2i driver 8, 15
Loading the Linux iSCSI offload bnx2i module 16
O
offload initiator 14, 15
offload status 12
overview 4
S
status, offload 12
supported hardware 4
supported operating systems 4
T
targets, discovering 17
troubleshooting 13
U
uninstalling 8, 14, 15
Index