Emulex installation and configuration
This is a quick doc to detail the steps we took to install the Emulex drivers and utilities on two ZCS servers at a customer site recently. I hope this will help save some time for somebody trying to connect a ZCS server to a storage array in the future. The cards used for this install were LP9002’s. None of this information is Zimbra-specific, it’s just general stuff that might be useful.
As of Feb 2, 2006, the latest version of the Emulex drivers is shipped on the RHEL 4 Update 2 CD set. At installation time, assuming the cards are installed, the installer will recognize them and will install the correct lpfc drivers for the cards. These instructions start at the point where the cards are physically installed and the lpfc drivers are in place.
1. Download latest helper apps and firmware from Emulex. For RHEL4 installations that already have the driver, Emulex provides a “Helper Module”. This module installs a driver called lpfcdfc that sits on top of the lpfc driver. You can download this package at www.emulex.com.
2. Pull gcc and devel versions of correct kernel from Red Hat. The Helper Module needs to be linked into the RHEL4 kernel. These packages need to be installed in order for the Helper Module installer to install the module into the kernel.
3. Run ioctl-install. The ioctl-install script in the lpfc_2.6_ioctl_module_kit-2.0.9-1 directory will compile and install the DFC driver.
4. Download and untar helper apps. Run install to install HBAnyware and lputil, along with other stuff. HBAnyware is the GUI version of Emulex’s configuration tool, and lputil works on the command line. lputil is generally handy to have. After installation, run lputil. It should immediately recognize the Emulex card(s) installed in the system and will print out their model numbers.
5. Download and install updated firmware. The current version of the firmware for the cards is at www.emulex.com. The build we used had two different versions of the update, one including the Boot ROM firmware update, and one for the base card firmware. The base card firmware is the only relevant one, unless you plan to boot off disks on the storage array, but you can use the combined one if you want. Use lputil to update firmware on the card, following the instructions provided with the firmware. Make sure you run it for each card in the system.
6. Pull the Compat-libstdc++-296 library set from RedHat. This library set is needed for the installation of the monitoring agent for EMC’s ECC package. This is only needed if you want ECC to monitor your system, and obviously isn’t required if you’re not running an EMC. If you don’t have this installed, you’ll see missing library errors at ECC installation time.