...
Document Version Release Date Details 2 12/04/2018 Added Migrating to Offload iSCSI for SUSE Linux Enterprise Server 11 SP4 steps to Resolution section. 1 10/10/2018 Original Document Release. On an HPE system configured with any network adapter listed in the Scope section, for certain Linux distributions, for example, Red Hat Enterprise Linux 6.9 and SUSE Linux Enterprise Server 11 SP4, the inbox iSCSI user space utility (Open-iSCSI tools) does not support qedi iSCSI transport and user space-initiated iSCSI functionality is not available. During a boot from a Storage Area Network (SAN) installation, the qedi driver can be updated using a Driver Update Disk (DUD). However, no interface or process exists to update userspace inbox utilities, causing the iSCSI target login and boot from SAN installation to not complete.
Any HPE system running certain Linux distributions for example, Red Hat Enterprise Linux 6.9 or SUSE Linux Enterprise Server 11 SP4 and configured with any of the following network adapters: HPE StoreFabric CN1300R Converged Network Adapter HPE StoreFabric CN1200R-T Converged Network Adapter HPE Synergy 4820C 10/20/25Gb Converged Network Adapter HPE Ethernet 10/25Gb 2-port 622FLR-SFP28 Converged Network Adapter
To overcome this limitation, perform the initial boot from SAN with the pure L2 interface (do not use hardware-offloaded iSCSI) using the following procedure during the boot from SAN. iSCSI offload for other distributions of Linux include the following information: I. Booting from SAN Using a Software Initiator To boot from SAN using a software initiator: Complete the following in the adapter's preboot device configuration (iSCSI Boot Configuration Menu): a. On all ports, set iSCSI Offload to Disable. b. On the Port Level Configuration page, select Boot Mode, and then press ENTER to select iSCSI (SW). Configure the initiator and target entries. Mount the Linux ISO image. Install Linux on the iSCSI disk over L2. Follow the instructions that apply to the specific Linux distribution as follows: For Red Hat Enterprise Linux 6.9: a. Boot into Linux, and type "e." At the grub edit> prompt, edit the kernel boot parameters by issuing the following command: grub edit> kernel /images/pxeboot/vmlinuz linux dd ip=ibft b. Unmount the Red Hat Enterprise Linux 6.9 ISO image, mount the DUD, and load the out-of-box drivers. c. After the out-of-box drivers are installed, remount the Red Hat Enterprise Linux 6.9 ISO image and complete the Linux installation. d. In the GNU GRand Unified Bootloader (GRUB) interface, select the kernel /vmlinuz-2.6.32... entry, and then type "e" to edit the kernel boot parameters. Issue the following command: <BOARDTYPE=pc KEYTABLE=us rd_LVM_LV=vg_prebooteit/lv_root rhgb quiet selinux=0 For SUSE Linux Enterprise Server 11 SP4: a. At the beginning of the installation, pass the following boot parameter with the DUD option: ip=ibft dud=1 Install Linux on the target LUN. II. Migrating from Software iSCSI Installation to Offload iSCSI Migrate from the non-offload interface to an offload interface by following the instructions for the specific Linux distribution as follows: Migrating to Offload iSCSI for Red Hat Enterprise Linux 6.9: To migrate from a software iSCSI installation to an offload iSCSI for Red Hat Enterprise Linux 6.9: Boot into the iSCSI non-offload/L2 boot-from-SAN operating system. Issue the following commands to install the open-iscsi and iscsiuio RPMs: # rpm -ivh --force qlgc-open-iscsi-2.0_873.111-1.x86_64.rpm # rpm -ivh --force iscsiuio-2.11.5.2-1.rhel6u9.x86_64.rpm Edit the /etc/init.d/iscsid file, add the following command, and then save the file: modprobe -q qedi Edit the /boot/efi/EFI/redhat/grub.conf file, make the following changes, and save the file: Remove ifname=eth5:14:02:ec:ce:dc:6d Remove ip=ibft Add selinux=0 Build the initramfs file by issuing the following command: # dracut -f Reboot the server, and then open the System Configuration. In the System Configuration, select the adapter port, and then select Port Level Configuration. On the Port Level Configuration page, set the Boot Mode to iSCSI (HW) and set iSCSI Offload to Enabled. Save the configuration and reboot the server. Linux can now boot through the offload interface. Migrating to Offload iSCSI for SUSE Linux Enterprise Server 11 SP4 To migrate from a software iSCSI installation to an offload iSCSI for SLES 11 SP4: Update open-iscsi tools and iscsiuio to the latest available versions by issuing the following commands: # rpm -ivh qlgc-open-iscsi-2.0_873.111.sles11sp4-3.x86_64.rpm --force # rpm -ivh iscsiuio-2.11.5.3-2.sles11sp4.x86_64.rpm --force Edit the /etc/elilo.conf file, make the following changes, and then save the file: Remove the ip=ibft parameter (if present) Add iscsi_firmware Edit the /etc/sysconfig/kernel file as follows: a. Locate the line that begins with INITRD_MODULES. This line will look similar to the following, but may contain different parameters: INITRD_MODULES="ata_piix ata_generic" or INITRD_MODULES="ahci" b. Edit the line by adding qedi to the end of the existing line (inside the quotation marks). For example: INITRD_MODULES="ata_piix ata_generic qedi" or INITRD_MODULES="ahci qedi " c. Save the file. Edit the /etc/modprobe.d/unsupported-modules file, change the value for allow_unsupported_modules to 1, and then save the file: allow_unsupported_modules 1 Locate and delete the following files: /etc/init.d/boot.d/K01boot.open-iscsi /etc/init.d/boot.open-iscsi Create a backup of initrd, and then build a new initrd by issuing the following commands. # cd /boot/ # mkinitrd Reboot the server, and then open the HII. In the HII, open System Setup, and then select System BIOS, Device Settings. On the Device Settings page, select the adapter port, and then select Port Level Configuration. On the Port Level Configuration page, set the Boot Mode to iSCSI (HW) and set iSCSI Offload to Enabled. Save the configuration and reboot the server. RECEIVE PROACTIVE UPDATES : Receive support alerts (such as Customer Advisories), as well as updates on drivers, software, firmware, and customer replaceable components, proactively via e-mail through HPE Subscriber's Choice. Sign up for Subscriber's Choice at the following URL: Proactive Updates Subscription Form. NAVIGATION TIP : For hints on navigating HPE.com to locate the latest drivers, patches, and other support software downloads for ProLiant servers and Options, refer to the Navigation Tips document . SEARCH TIP : For hints on locating similar documents on HPE.com, refer to the Search Tips Document . To search for additional advisories related to Linux, use the following search string: +Advisory +ProLiant -"Software and Drivers" +Linux