QuantaStor Driver Upgrades
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.
NOTE: This guide does not apply to QuantaStor 4 and newer versions. If you need assistance with a driver upgrade please contact OSNEXUS support.
- 1 QuantaStor 3 Driver Upgrade Overview
- 2 Driver Updates for QuantaStor v3.x with 3.8 kernel
- 3 Driver Updates for QuantaStor v2.x
QuantaStor 3 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 email@example.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
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, <firstname.lastname@example.org> 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, <email@example.com> 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 firstname.lastname@example.org 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