File Name: Linux_RDAC_readme.TXT Software package for IBM TotalStorage™ FAStT Linux RDAC. Version : 08.40.A5.00 Last Update Date: 04/21/2004 Refer to the IBM TotalStorage™ Disk Storage Systems Technical Support web site for the latest information and updated readme file. Products Supported: --------------------------------------------------- | | Machine Type | Model | |-----------|--------------|------------------------| | FAStT 900 | 1742 | 90X , 90U | |-----------|--------------|------------------------| | FAStT 700 | 1742 | 1RX, 1RU | |-----------|--------------|------------------------| | FAStT 600 | 1722 | 60U , 60X | --------------------------------------------------- CONTENTS --------- 1.0 Overview 2.0 Change History 3.0 Installation and Setup Instructions 4.0 Configuration Information 5.0 Unattended Mode 6.0 Web Sites and Support Phone Number 7.0 Trademarks and Notices 8.0 Disclaimer 1.0 Overview: 1.1 Description This is the initial release for the IBM TotalStorage™ FAStT Linux RDAC. This is a limited release of the RDAC code for 32 bit Intel architecture servers only. Please refer to the Dependencies for the required code levels and Linux kernel versions. Deviations from the listed code levels in Dependencies are not supported. Refer to the http://www.ibm.com/storage/support/fastt IBM TotalStorage™ Disk Storage Systems Technical Support web site for the latest supported host adapters, device drivers, Linux kernel versions and updated readme. 1.2 Limitations 1. Linux RDAC is supported in a 32 bit Intel Architecture Servers. These servers must be configured in the FAStT Storage Server homogeneous environment. The FAStT heterogenous environment with servers having Linux and non-Linux Operating Systems sharing the same FAStT Storage Server is currently not supported. 2. The Linux RDAC driver cannot co-exist with a HBA-level multipath failover/failback driver such as the 6.06.63-fo driver. You might have to modify the driver make file for it to be compiled in the non-failover mode. 3. SteelEye's™ LifeKeeper® Clustering is currently supported with 8 luns only. Please use the following instructions setting up the LifeKeeper® cluster. a. Recompile the Fibre Channel Host Bus Adapter driver using the following setting. - Change the setting QLA2X_PERFORMANCE to 0 in the qla_settings.h file. b. Change the following setting in the /etc/default/LifeKeeper file. LCMHBEATTIME=5 LCMNUMHBEATS=16 c. Reboot the Linux host after completing steps a and b . 3. Linux RDAC is not supported with FAStT Storage Servers connected to SATA drive technology EXP100 Drive Expansion Enclosure. Please contact IBM Resellers or Representatives for updates regarding the availability of such support in the future. 4. All limitations which apply to the current FAStT Storage Server when configures with Linux servers also apply to this Linux RDAC release. 5. FAStT Storage Server In-band management is currently not supported. The FAStT Storage Server Universal Access LUN (UTM) should not be mapped to the storage partition. 6. AVT mode is not supported at this time. AVT is automatically enabled in the Linux storage partitioning host type. It has to be disabled using the script that is bundled in this Linux RDAC web package. Use the following steps to disable the AVT mode in your Linux host type partition. Open the FAStT Storage Manager Enterprise Management window, - Highlight the subsystem - Select Tools - Select Execute script. - A script editing window opens. In this window - Select File - Select Load Script - Give the full path name for the script file (eg . /usr/scripts/avtdisable.scr) and click OK - Select Tools - Select Verify and Execute Please refer to the IBM TotalStorage FAStT Storage Manager version 8.4x Installation and Support Guide for appropriate OS or the Enterprise Window Online help for more information on how to execute a script. 7. The Linux SCSI layer does not support skipped (sparse) LUNs. If the mapped LUNs are not contiguous, the Linux kernel will not scan the rest of the LUNs. Therefore, the LUNs after the skipped LUN will not be available to the host server. The LUNs should always be mapped using consecutive LUN numbers. 8. The SMdevices program does not report LUNs beyond the LUN number that the FAStT Storage Server Universal Access LUN (UTM LUN) is mapped to. The UTM LUN should not be mapped anyway because in-band management is currently not supported. 9. Fibre channel configuration. If a host server has multiple HBA ports and each HBA port sees both controllers (via a un-zoned switch), the Linux RDAC driver may return I/O errors during controller failover. The recommendation is to use multiple unconnected FC switches to zone the FC switch into multiple zones so that each HBA port sees only one controller in a FAStT Storage Server. 10. The RDAC driver reports I/O failures immediately after all paths are failed. When the RDAC driver detects that all paths to a FAStT Storage Server are failed, it will report I/O failure immediately. This behavior is different from the IBM FC HBA failover driver. The IBM FC HBA failover driver will wait for a certain time period before reporting an I/O failure to the host application. There is no work-around. 1.3 Enhancements N/A 1.4 Level of Recommendations and Prerequisites for the Update: N/A 1.5 Dependencies: The following code levels must be used. Deviations from the listed code levels are not supported. a. FAStT Storage Server Controller firmware and NVSRAM: - For FAStT900 : firmware -> FW_05400900_05400300 NVSRAM -> N1742F900R840V00 - For FAStT700 : firmware -> FW_05400900_05400300 NVSRAM -> N1742F700R840V04 - For FAStT600 Turbo option: firmware -> SNAP_05400900 NVSRAM -> N1722F600R840V02 - For FAStT600 : firmware -> SNAP_05400900 NVSRAM -> N1722F600R840V02 b. IBM FAStT, FC-2 and FC2-133 Fibre Channel Host Bus Adapters - 6.06.63 non-failover Note: The FC HBA device driver must be non-failover version. c. Linux Kernel version - For RedHat AS 2.1 : 1.4.9-e.27 smp - For SuSe SLES 8 : 2.4.19-64GB-smp d. FAStT-MSJ Release 42 e. IBM FAStT Storage Manager Host software - SMruntime : SMruntime-Linux-08.40.A5.00-1.i386 - SMClient : SMclient-Linux-08.41.G5.01-1.i386 - SMutil : SMutil-Linux-08.40.A5.00-1.i386 Refer to the http://www.ibm.com/storage/support/fastt IBM TotalStorage™ Disk Storage Systems Technical Support web site for the latest update to the supported host adapters, device driver levels, Linux kernel versions, FAStT controller firmware versions and readme. 2.0 Change History -------------------- Version 08.40.A5.00 - 04/05/2004 - This is the initial release. 3.0 Installation and Setup Instructions ----------------------------------------- 3.1 Prerequisites 1. The Linux RDAC driver is released as a source-code package in the format of a gunzip compressed tar file. To unpack the driver source package, type the following command in the Linux console window: tar -zxvf ibmrdac-LINUX-xx.xx.xx.xx-source.tar.gz where xx.xx.xx.xx is the release version of the RDAC driver. The source files will uncompress to the "linuxrdac" directory. 2. The Host server must have the non-failover Fibre Channel HBA device driver properly built and installed before the Linux RDAC driver installation. Refer to the FC HBA device driver README or the FC HBA User Guide for instructions on installing the non-failover version of the device driver. The driver source tree is included in the package if you need to build it from the source tree. 3. Although the Host server can have different FC HBAs from multiple vendors or different FC HBA models from the same vendors, only one model of FC HBAs can be connected to the IBM FAStT Storage Servers. 4. Check for the following entries in the appropriate file for a given Linux OS distribution. a. On RedHat AS 2.1 servers, it is assumed that there is a scsi_hostadapter entry for the physical HBA driver(s in the /etc/modules.conf file. For example, if the system has the IBM FC2-133 FC HBA, there should be a scsi_hostadapter entry such as alias scsi_hostadapterx qla2300 a. On SuSe SLES 8 servers, it is assumed that the low-level HBA driver names are included in the INITRD_MODULES string in the /etc/sysconfig/kernel file. For example, if the system has the IBM FC2-133 FC HBA, INITRD_MODULES string should include the word "qla2300". 5. The kernel source tree for the Linux kernel version to be built against should already be installed before RDAC driver package installation. 3.2 Build and Installation 3.2.1. SUSE Distribution Setup Instructions. For RedHat AS 2.1, proceed to step b. a. Install the kernel-source from the SUSE distribution. b. create a soft link to the kernel source. ln -sf /usr/src/ /usr/src/linux c. To ensure kernel version synchronization between the driver and running kernel, type the following in the Linux console window. Press Enter after each command. - cd /usr/src/linux - make mrproper (completely clean the kernel tree) - make menuconfig make cloneconfig or cp /boot/vmlinuz.config .config (copy the new config) make oldconfig (update configuration using .config) - make dep (rebuild the dependencies) - make modules (build the modules-not require on newer kernel version) 3.2.2. RDAC Driver Building for SuSe and RH. a. Change to the "linuxrdac" directory. b. To remove the old driver modules in that directory, type the following and press Enter: make clean c. To compile all driver modules and utilities in a multiple CPUs server (SMP kernel), type the following and press Enter: make 3.2.3. RDAC Driver Installation a. To copy driver modules to the kernel module tree and build the new RAMdisk image (mpp.img) which includes RDAC driver modules and all driver modules that are needed during boot time. Type the following and press Enter: make install b. Follow the instructions display at the end of the build process to add a new boot menu option which uses /boot/mpp.img as the initial RAMdisk image. IMPORTANT: If your system is a RedHat AS 2.1, please note edit the /sbin/mkinitrd script in the following area to change 3000 to 15000: if ['uname -m' = "ia64"]; then IMAGESIZE=400 else IMAGESIZE=15000 fi The following instructions may work in certain RedHat kernel version - add "ramdisk_size=15000" as a kernel boot parameter in the new boot option, similar to the following grub.conf example (Notes that it may vary in accordance with different system setup configuration): title Red Hat Linux Advanced Server-up (2.4.9-e.27smp) root (hd0,6) kernel /vmlinuz-2.4.9-e.27smp ro root=/dev/hda7 ramdisk_size=15000 initrd /mpp.img 3.3 RDAC Driver Post-Installation a. Reboot the system using the new boot menu option. b. To verify that sd_mod, sg, mpp_Upper, qla2300, and mpp_Vhba were loaded after the reboot, type the following and press Enter: /sbin/lsmod c. To verify that the RDAC driver discovered the available physical Luns and created virtual Luns for them, type the following and press Enter: ls -lR /proc/mpp d. You can now issue I/Os to the Luns. e. If you make any changes to MPP configuration file (/etc/mpp.conf) or persistent binding file (/var/mpp/devicemapping), please run mppUpdate to re-build RAMdisk image to include the new file so that the new configuration file (or persistent binding file) can be used on the next system reboot. f. To dynamically re-load the driver stack (scsi_mod, sd_mod, sg, mpp_Upper, , mpp_Vhba) without rebooting the system, you need to first comment out all "scsi_hostadapter" entries in /etc/module.conf. Then, issue "modprobe -r mpp_Upper" to unload the driver stack and follow by "modprobe mpp_Upper" to re-load the driver stack. g. The file /etc/syslog.conf should have entries for kern.debug, kern.notice, kern.info and kern.warning in order to capture all debug and error messages for MPP driver. 3.4 Persistent Naming Linux SCSI device names have the possibility of changing when the host system reboots. We recommend using a utility such as devlabel to create user-defined device names that will map devices based on a unique identifier, called a UUID. As of this writing, devlabel is available as part of the Red Hat Enterprise Linux 3 distribution, or online at: http://www.lerhaupt.com/devlabel/devlabel.html. 3.5 RDAC Driver Package Uninstall and Reinstall/Update To un-install the RDAC driver package, type the following and press Enter: make uninstall Note: To Reinstall/Update the RDAC driver package, you need to issue the command "make uninstall" followed by the "make install" command under the /linuxrdac directory in the new RDAC driver source code bundle. 4.0 Configuration Information ------------------------------- 4.1 Configuration installation N/A 4.2 Configuration Settings N/A 4.3 Hardware Status and Information N/A 5.0 Unattended Mode ------------------------------- N/A 6.0 WEB Sites and Support Phone Number ---------------- 6.1 IBM TotalStorage™ Disk Storage Systems Technical Support web site: http://www.ibm.com/storage/support/fastt 6.2 IBM TotalStorage™ Marketing Web Site: http://www.storage.ibm.com/hardsoft/disk/fastt/index.html 6.3 If you have any questions about this update, or problems applying the update go to the following Help Center World Telephone Numbers URL: 800-IBM-SERV (800-426-7378) Hardware Support #: 800-426-4378 Software Support #: 800-237-5511 6.4 Website for the World Wide Support Phone list: http://www.pc.ibm.com/qtechinfo/YAST-3P2QYL.html. 7.0 Trademarks and Notices ---------------------------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM FAStT TotalStorage™ the e-business logo xSeries HelpCenter Linux is a registered trademark of Linus Torvalds. Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United states, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. STEELEYE are TRADEMARKS and LIFEKEEPER is a registered trademark of STEELEYE TECHNOLOGY, INC. 8.0 Disclaimer ---------------------------- 8.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 8.2 Note to Government Users Include the following note after the disclaimer paragraph. Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.