
                Installation Notes

    QLogic Everest FastLinQ Linux Drivers Packages
        	QLogic Corporation
        Copyright(c)2016 QLogic Corporation
        	All rights reserved


Table of Contents
=================

  Introduction
  Installation of FastLinQ RPM Packages
  Uninstallation of FastLinQ RPM Packages
  Installation of FastLinQ DEB Packages
  Uninstallation of FastLinQ DEB Packages
  Loading and Removing Kernel Drivers
  Operating system installation using Driver Update Disks
  Importing public keys for secure boot
  Known Issues

Introduction
============

This file describes the installation procedures for the fastlinq driver's 
Kernel Module Packages. These RPMS install following drivers.

- QED (QLogic Everest Driver) core module for QL4xxx Series converged network
  interface cards.

- QEDE (Qlogic Everest Driver for Ethernet) networking driver for QL4xxx Series
  converged network interface cards.

- QEDR (QLogic Everest Driver for RoCE) driver for QL4xxx series of converged
  network interface cards.

- LIBQELR (QLogic Everest Library for RoCE) userspace driver for QL4xxx series
  of converged network interface cards.


Installation of fastlinq RPM Packages
=======================================

  To install the Kernel Module RPM run following command with root privilege 

  SuSE:
    Kernel Module Package
    # rpm –Uvh qlgc-fastlinq-kmp-default-<module version>_<kernel>-1.<distro>.<arch>.rpm

    Userspace Module Package
    # rpm -Uvh qlgc-libqedr-<module version>-1.<distro>.<arch>.rpm

  Redhat:
    #rpm –Uvh kmod-qlgc-faslinq-<module version>-1.<distro>.<arch>.rpm

    Userspace Module Package
    # rpm -Uvh qlgc-libqedr-<module version>-1.<distro>.<arch>.rpm

 

Uninstallation of fastlinq RPM Packages
=======================================

  To un-install the Kernel Module RPM run following command with root privilege 

    # rpm -e qlgc-fastlinq



Installation of FastLinQ DEB Packages
=======================================

  To install the FastLinQ DEB packages run following command with root privilege 

    # dpkg -i fastlinq-dkms_<version>_all.deb


Uninstallation of FastLinQ DEB Packages
=======================================

  To un-install the FastLinQ DEB packages run following command with root privilege 

    # dpkg -r fastlinq-dkms


Loading and Removing Kernel Drivers
===================================

- Loading a kernel driver:

  `modprobe <qed/qede/qedr>'

  Due to dependency between the drivers, probing of QEDE will probe also QED,
  and probing of QEDR will probe also QEDE and QED.

- Removing a kernel driver:

  Removing driver should be performed in following order if the modules are present
  - rmmod qedr
  - rmmod qede
  - rmmod qed

Operating system installation using Driver Update Disks
========================================================

To install Operating System using DUD, select appropriate action from following
and follow on-screen instructions.

  SuSE 11.x/12.x with BIOS:
    - Boot from the installation medium. 
    - Select F5/F6 for DUD

  SuSE 11.x/12.x with UEFI:
    - Boot from the installation medium.
    - Press 'e' to edit bootloader entry.
    - Append "driverupdate=1" to the kernel line

  Redhat:
    - Boot from the installation medium.
	Redhat limits loading of drivers from DUD as the inbox module support is
	available. If user desires to install drivers from DUD during installation, 
	following workaround would be needed to blacklist inbox module.

	1) Add the following to the kernel command line when booting from the installation media:
	modprobe.blacklist=qed modprobe.blacklist=qede modprobe.blacklist=qedr modprobe.blacklist=qedi modprobe.blacklist=qedf

	2) Then during first boot, add following kernel command line for desired drivers
	rd.driver.pre=qed,qede,qedr,qedf,qedi

	3) Once system is booted successfully edit /etc/modprobe.d/anaconda-blacklist.conf 
	to remove blacklist entry of the desired driver

	4) Rebuild the ramdisk and reboot.

  XenServer 7.1
    XS7.1 makes it mandatory to sign the RPM. The "Update" cannot be installed without
    importing public key.
    Public key location: http://ldriver.qlogic.com/XS-public-key/

Importing public keys for secure boot
=====================================

To load the drivers in secure boot environment, public keys will have to be imported.
Following are the instructions to import QLogic public key for Linux drivers.

    - Make sure your server supports secure boot.
    - Download public key from http://ldriver.qlogic.com/Module-public-key/
    - Install the public key with following command and reboot.
	
        # mokutil --root-pw --import cert.der
        The --root-pw option enables usage of the root user directly.

    - Check the list of certificates that are prepared to be enrolled:
        # mokutil --list-new
    - Reboot the system; shim should launch MokManager. You need to enter the
      root password to confirm the import of the certificate to the MOK list.

    - Check if the newly imported key was enrolled:
        # mokutil --list-enrolled

    - Alternatively, this is the procedure if you want to launch MOK manually:
        # reboot
        - In the GRUB 2 menu press the 'c' key.
        - Type: chainloader $efibootdir/MokManager.efi
        - boot

        - Select Enroll key from disk.
        - Navigate to the cert.der file and press Enter.
        - Follow the instructions to enroll the key. Normally this should be 
          pressing '0' and then 'y' to confirm.

     - Alternatively, the firmware menu may provide ways to add a new key to the Signature Database.

Reference: https://www.suse.com/documentation/sled-12/book_sle_admin/data/sec_uefi_secboot.html

Known Issues:
=============
Known Issue:
Due to an issue in Redhat 6.x installer, drivers from DUD don’t get included in the initird.
This results in failure to load fastlinq drivers after a reboot.
Details of the issue can be tracked via Redhat Bugzilla: https://bugzilla.redhat.com/show_bug.cgi?id=1373654

