QuantaStor Driver Upgrades

From OSNEXUS Wiki
Jump to: navigation, search

As new hardware models become available there are occasions where you may need to upgrade your QuantaStor systems' drivers in order to enable your hardware.

Driver Upgrade Overview

QuantaStor ships with all the kernel header packages installed so that new drivers can be compiled to support new hardware that may not have been available at the time the QuantaStor kernel was originally built. OSNEXUS provides a QuantaStor kernel at least once per year. QuantaStor's most recent kernel is derived from the 3.19 kernel for Ubuntu Server 14.04.3 LTS. For paid subscriptions please contact OSNEXUS support via support@osnexus.com to get assistance with any driver upgrades.

Driver Updates for QuantaStor v3.x with 3.8 kernel

To apply the following driver updates you'll need to login to your QuantaStor system at the console or via SSH. If you've a Windows desktop you can download the PuTTY SSH client <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">here</a>. Using PuTTY or any other SSH utility you can remotely login to your QuantaStor system using the 'qadmin' user account. The default password for the 'qadmin' account is 'qadmin'. After you login via SSH you'll need to change roles to 'superuser' using the 'sudo -i' command so that you can install the drivers. (Important Note: You should change qadmin password if you haven't already! Once you 'sudo -i' just type 'passwd qadmin' to change it.)

LSI MPT Fusion SAS 3.0 Device Driver

The mpt3sas driver included with QuantaStor is an older v1 driver. To add support for the latest v5 driver run these commands:

sudo -i
wget http://www.osnexus.com/storage/drivers/lsi/mpt3sas.ko
mv /lib/modules/3.8.0-8-quantastor/kernel/drivers/scsi/mpt3sas/mpt3sas.ko /lib/modules/3.8.0-8-quantastor/kernel/drivers/scsi/mpt3sas/mpt3sas.ko.orig
chmod 644 mpt3sas.ko
cp mpt3sas.ko /lib/modules/3.8.0-8-quantastor/kernel/drivers/scsi/mpt3sas/mpt3sas.ko
depmod -a


Intel 10GbE driver update for X540, X520, and related NICs

Here are the commands to run to upgrade your Intel 10GbE network driver to v3.21.2. If you can, copy and paste these commands to the SSH/PuTTY console window to save typing and avoid typos.

sudo -i
wget http://www.osnexus.com/storage/drivers/qs-3808-kernel/ixgbe.ko
chmod 644 ixgbe.ko
mv /lib/modules/3.8.0-8-quantastor/kernel/drivers/net/ethernet/intel/ixgbe/ixgbe.ko ./ixgbe.old
cp ixgbe.ko /lib/modules/3.8.0-8-quantastor/kernel/drivers/net/ethernet/intel/ixgbe/ixgbe.ko
depmod -a

The new driver should now be running. Run this command to check the version output:

modinfo ixgbe | grep -v alias

The output should include lines like these with the driver version indicating 3.21.2:

filename:       /lib/modules/3.8.0-8-quantastor/kernel/drivers/net/ethernet/intel/ixgbe/ixgbe.ko
version:        3.21.2
license:        GPL
description:    Intel(R) 10 Gigabit PCI Express Network Driver
author:         Intel Corporation, <linux.nics@intel.com>
srcversion:     BF07A1334753C2C8BFAA989

After you've installed the new driver you should reboot then run the above mentioned command again to verify that the latest version of the driver is now running.

Intel 1GbE driver update

Here are the commands to run to upgrade your Intel 1GbE / e1000 network driver to v5.0.6. If you can, copy and paste these commands to the SSH/PuTTY console window to save typing and avoid typos.

sudo -i
wget http://www.osnexus.com/storage/drivers/qs-3808-kernel/igb.ko
cp igb.ko /lib/modules/3.8.0-8-quantastor/kernel/drivers/net/igb/igb.ko
chmod 644 /lib/modules/3.8.0-8-quantastor/kernel/drivers/net/igb/igb.ko
/sbin/depmod -a

Run this command to verify the version:

root@quantastor:~# modinfo igb | grep -v alias

filename:       /lib/modules/3.8.0-8-quantastor/kernel/drivers/net/igb/igb.ko
version:        5.0.6
license:        GPL
description:    Intel(R) Gigabit Ethernet Network Driver
author:         Intel Corporation, <e1000-devel@lists.sourceforge.net>
srcversion:     7D5C0C9D2D9DF9F98067FA5
depends:        dca
vermagic:       3.8.0-8-quantastor SMP mod_unload modversions

You should now reboot, then check the version again.

Driver Updates for QuantaStor v2.x

QuantaStor uses a modified kernel which includes optimizations for iSCSI and some necessary modifications for FibreChannel support. Beyond that it's a stock Ubuntu Server kernel with all the headers included so you can build new drivers on your own. Building drivers can be a bit tricky though so if you have a subscription license and need a new driver just write to support@osnexus.com and we'll assist. Instructions for installing new drivers not included with our kernel will always be posted here for everyone's benefit.

Chelsio T4 driver

The following steps outline how to download the Chelsio T4 driver, set the permissions on the driver, and install it.

wget http://www.osnexus.com/storage/drivers/chelsio_t4_driver.tgz
tar xvfz chelsio_t4_driver.tgz
cd chelsio_t4_driver
chmod 644 cxgb4.ko
cp *ko /lib/modules/2.6.35-27-quantastor/extra
depmod
modprobe cxgb4

Run these commands to verify that the module is loaded and running:

lsmod | grep cxgb4
modinfo cxgb4 | more

Intel 10GbE driver

The following steps outline how to download the driver, set the permissions on the driver, make a backup of the old driver, and install the new one.

wget http://www.osnexus.com/storage/drivers/ixgbe.ko
chmod 644 ixgbe.ko
mv /lib/modules/2.6.35-27-quantastor/kernel/drivers/net/ixgbe/ixgbe.ko /lib/modules/2.6.35-27-quantastor/kernel/drivers/net/ixgbe/ixgbe.ko.distrib
cp ixgbe.ko /lib/modules/2.6.35-27-quantastor/kernel/drivers/net/ixgbe/ixgbe.ko
depmod

The stock driver with QuantaStor v2 is 3.4.24-NAPI, this new driver updates to ixgbe 3.11.33. After you reboot you'll want to run this command to verify the driver version now reads 3.11.33

modinfo ixgbe | more

LSI MegaRAID 92xx Driver, Firmware, and CLI upgrade

As new models of LSI's MegaRAID controller become available it is sometimes necessary to upgrade your driver, firmware, and the MegaCLI. To upgrade your QuantaStor v2 system with the latest MegaRAID driver, firmware and CLI as of 3/8/2013 please run these commands from the console of your QuantaStor system.

sudo -i
cd ~
wget http://www.osnexus.com/storage/drivers/megaraid_qsv2_06504/update_megaraid.sh
chmod 755 update_megaraid.sh
./update_megaraid.sh

Replace the -a0 with the correct number for your RAID controller. If you have only one controller then you can use -a0 but if you have multiple controllers of different types be careful to make sure you're applying the correct firmware to the correct controller.

To upgrade the firmware afterward you'll need to run the following command, it is also printed out at the end of the update_megaraid.sh script.

WARNING: This firmware applies to the MegaRAID 9266/9286/9271 controllers, do not apply it to the Nytro MegaRAID controllers.

MegaCli -adpfwflash -f mr2208fw.rom -a0

WARNING: This firmware applies to the Nytro MegaRAID controllers, do not apply it to standard MegaRAID controllers.

MegaCli -adpfwflash -f NytroMrFw.rom -a0

Brocade 10GbE Network Adapter driver

Adds support for the Brocade 10GbE network cards with the bna.ko driver.

sudo -i
cd ~
wget http://www.osnexus.com/storage/drivers/bna_install.sh
chmod 755 bna_install.sh
./bna_install.sh