User manual HP OTHER MULTI-PATH SOFTWARE-LINUX STORAGEWORKS MULTIPULSE FAILOVER DRIVER FOR LINUX APPLICATION NOTES (AA-RWENC-T

[. . . ] Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. [. . . ] Enter the following command to untar hp-lpfc-<date>. tar. gz: # tar zxvf hp-lpfc-<date>. tar. gz The <date> is the release date of the . gz file. Change to the newly created hp-lpfc-<date> directory: # cd hp-lpfc-<date> 3. Run the INSTALL script: # . /INSTALL -m When the installation is complete, the following RPMs are installed: · hp-lpfc ­ Base HBA driver · hp-multipulse ­ MultiPulse driver · fibreutils ­ Utility script NOTE: You must use the base driver in the hp-lpfc RPM. Uninstalling the driver Use one of the following methods to uninstall the driver: · Specify the -u flag with the INSTALL command: # . /INSTALL -u · Manually uninstall the kit by uninstalling the RPMs: # rpm -e hp-multipulse # rpm -e hp-lpfc # rpm -e fibreutils NOTE: To revert to the base HBA driver, uninstall only the hp-multipulse RPM: # rpm -e hp-multipulse MultiPulse failover driver for Linux application notes 5 Driver parameters Table 2 lists the MultiPulse driver parameters. Table 2 MultiPulse driver parameters Parameter lpfc_nodev_tmo Description Time, in seconds, that the driver holds I/O for a device that is no longer accessible. The default value is 30 seconds for single-path configurations. The MultiPulse installation changes this value to 10 seconds so that path failure notification occurs more quickly. The installation does not change the default value. Number of kernel threads that are created during device discovery. This value ensures that the discovery process occurs serially (one by one) in the order in which the name server in the fabric returns world wide names (WWNs). The installation does not change the default value. lpfc_lun_queue_depth lpfc_discovery_threads Important information Tape discovery issues The installation procedures for the Emulex Fibre Channel driver kits and the associated Linux fibreutils utility have changed for Enterprise Backup Solution (EBS) configurations. The MultiPulse driver (and fibreutils) release contains a fix for intermittent device discovery issues with SCSI-2 automated tape libraries. Install the HBA driver and fibreutils package using one of the following procedures: · Run the INSTALL script included in the driver kit. · Install the driver, optional multipath software, and fibreutils RPMs. Enter the following commands to run the pbl script in the fibreutils directory: # cd /opt/hp/hp_fibreutils/pbl # . /pbl_inst. sh -i 3. Reboot the server to complete the installation. Note the following: · Running the pbl script installs the probe-luns utility, which runs probe-luns as part of the boot cycle. · Running the fix procedure (steps 1 through 3) eliminates the need to run hp_rescan ­a in the /etc/rc. local directory for tape device discovery. If you previously added hp_rescan -a to rc. local (or another startup script), remove it from the rc. local. 6 Manual rescan When a server configured with MultiPulse first boots, MultiPulse automatically recognizes up to four physical paths and associates them with the same virtual device. However, after the initial configuration, MultiPulse does not recognize a new physical path that comes online to an already configured LUN. To enable MultiPulse to recognize the new physical path, you must perform a manual rescan using the hp_rescan utility. [. . . ] However, note that MultiPulse only works with Emulex-based HBAs; it will not configure multiple paths for other HBAs in the system. · When using MultiPulse with SUSE Linux systems in Boot from SAN configurations, HP recommends that you use the Udev utility to ensure that your system successfully boots. For detailed information about this procedure, see "Using the Udev utility with SUSE Linux systems" in the Booting Itanium Linux systems from a storage area network application notes, available on the website http://h18006. www1. hp. com/storage/saninfrastructure. html. · XP LUNs presented to Linux hosts must start with LUN 0. [. . . ]