QLogic SANSurfer Pro for Linux AMD 64bit (AMD64) operating system environments only version 2.0.30b62. This program was previously released as IBM FAStT Management Suite Java (FAStT MSJ). Starting with this release, IBM will not release separately an IBMized version of the QLogic SANSurfer HBA Manager or SANSurfer PRO program. The terms FAStT MSJ and SANSurfer will be used interchangeably from this release forward. NOTE TO SERVICE – Reference RETAIN # N/A (C) Copyright International Business Machines Corporation 1999, 2005. All rights reserved. US Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Note: Before using this information and the product it supports, read the general information in "Notices and trademarks” in this document. Important: Please refer to section 10.0 for the limitations in this version of SANSurfer. Last update: 02/13/2006 CONTENTS -------- This readme file includes the following information: 1.0 Overview 2.0 Components 3.0 Configuration 4.0 Requirements 5.0 Downloading and installing SANsurfer 6.0 Executing SANsurfer 7.0 Uninstalling SANsurfer 8.0 Limitations 9.0 Web Sites and Support Phone number 10.0 Trademarks and Notices 11.0 Disclaimer =================================================================== 1.0 OVERVIEW ------------ Qlogic SANsurfer supports the following HBA's: ----------------------------------------------------------------------------- | FAStT Adapter | Qlogic Adapter | IBM Feature Code | IBM Option P/N | ------------------------------------------------------------------------------ |FAStT Host Adapter | QLA2200F/66-IBM-SP | FC2102 | 00N6881 | |FAStT FC2 | QLA2310FL-IBM-SP | FC2130 | 19K1246 | |FAStT FC2-133 | QLA2340-IBM-SP | FC2104 | 24P0960 | ----------------------------------------------------------------------------- Some of the features include: · Timely and accurate detection of I/O failures · Local and remote management of adapters · Device \ Port Configuration for fail-over capability (Linux) · Performance statistics · Central control point in a network environment · Diagnostics & utilities Please refer to the corresponding Change History document for information on new features and modifications. There are four QLogic SANsurfer packages for different Linux kernel versions - IA32(X86), IA64(Itanium II), AMD64 and Linux on Power (LoP.) Please select the appropriate package for your Linux kernel version. =================================================================== 2.0 COMPONENTS -------------- Qlogic SANsurfer consists of the following components. · Qlogic SANsurfer Application: This is a Java based GUI application that runs on any Linux system network-connected to the host servers. It manages the Fibre Channel Host Bus adapters on these servers that connected to FAStT Storage Server. · Qlogic SANsurfer Agent: This software is required on systems where the Host Bus adapters reside. . Wrap Connector and Coupler The IBM FAStT Host Bus Adapters (2200 and above) support Full Duplex mode which enables loop back capability. To assist you in isolating 2200 HBA loop problems, a wrap connector/coupler assembly P/N 75G2725 can be obtained from Mechanicsburg or by contacting IBM Level 2 Support. For the 23xx a wrap plug P/N 11P3847 and coupler P/N 05N6766 are included in the DS4000 Storage Subsystem shipping box. You can also obtain them from Mechanicsburg as a kit (P/N 24P0950). =================================================================== 3.0 CONFIGURATION ----------------- The configurations that Qlogic SANsurfer supports can be divided into two types: Stand-alone and Networked. 3.1 STAND-ALONE --------------- If you will manage the Host Bus adapter installed in a stand-alone system, install the Qlogic SANsurfer GUI and Qlogic SANsurfer Linux Agent on that system 3.2 NETWORKED ------------- If you will manage the Host Bus adapter residing in a remote system in a Linux environment, install the Qlogic SANsurfer GUI on a management system. In this case, only the Qlogic SANsurfer Linux agent needs to be installed in the remote system. Note that a management system may contain HBAs and therefore the agent should also be installed on that system. =================================================================== 4.0 REQUIREMENTS ----------------- 4.1 HARDWARE REQUIREMENTS -------------------------- · IBM FAStT Fibre Channel HBAs (2200, 2310, 2340 or 2342) · Single or Multi-processor Server or Workstation. · AMD 64bit (AMD64) processors, 1024MB RAM,and a minimum 180MB disk space. 4.2 SOFTWARE REQUIREMENTS FOR Linux OS --------------------------------------- · Linux (IA-64 kernels only) · Must have "root" privileges · HBA Device Driver: 7.05.00 or later for Linux 2.4 kernels (SLES8 and RHEL3) 8.00.02 or later for Linux 2.6 kernels (SLES9 and RHEL4) · TCP/IP Protocol · Must have Administrative Privileges to perform management functions(NVSRAM modification). =================================================================== 5.0. INSTALLING Qlogic SANsurfer --------------------------------- If you have downloaded the Qlogic SANsurfer package from the IBM Support web site, skip to Web Download section below. 5.1 CD Installation ------------------- The following files are located in the FAStT_MSJ folder in the CD. Linux · README.txt (this file) Note: The README file that is on this CD takes precedence over the one that is displayed and installed when Qlogic SANsurfer setup is run. · sansurfer2.0.30b62_linux_install_amd64-i.bin (the install file for Linux Qlogic SANsurfer) Refer to the online help for information on how to use different features of the SANSurfer program. In addition, the DS4000 storage subsystem Problem Determination Guide also contains information on how to use the program to diagnose Fibre Channel path problems. This guide is available as a pdf file at the IBM DS4000 Technical Support web site. 5.2 WEB Download ---------------- Note: The web-download QLogic SANsurfer software package must be first unpacked (tar -xvz) into a user-defined directory. Then, go to this directory to locate the software installation file. The package includes the following: · README.txt (the Readme file for Qlogic SANsurfer) Note: The README file that is part of this self extracting file takes precedence over the one that is displayed and installed when Qlogic SANsurfer setup is run. · sansurfer2.0.30b62_linux_install_amd64-i.bin (the install file for Linux Qlogic SANsurfer) Refer to the online help for information on how to use different features of the SANSurfer program. In addition, the DS4000 storage subsystem Problem Determination Guide also contains information on how to use the program to diagnose Fibre Channel path problems. This guide is available as a pdf file at the IBM DS4000 Technical Support web site. 5.3 Installation ---------------- The sansurfer2.0.30b62_linux_install_amd64-i.bin installs the Qlogic SANsurfer Application. Depending on your requirements, not all components may be installed. Important: If Qlogic SANsurfer is already installed, un-install it prior to installing a new copy. GUI Installation: 1. Open a shell and change to the directory that contains the Qlogic SANsurfer installer. 2. At the prompt, type the following command to start the program installation wizard. sh ./sansurfer2.0.30b62_linux_install_amd64-i.bin 3. At the "Choose Product Features" Windows, select the one of the two preconfigured installation sets listed below or select Custom to define an installation set. Then click Next. - ALL GUIs and ALL Agents to install the SANsurfer FC HBA Manager, the SANsurfer FC HBA Manager, and SANsurfer Switch Manager GUIs, including the FC and iSCSI (Windows, Linux, or Solaris) agents. - SANsurfer FC HBA Manager to install only the SANsurfer FC HBA Manager GUI. Note: Do not select the following installation set unless they are applicable to your configuration. These functions are not supported by the DS4000 storage subsystem product support. - SANsurfer Switch Manager GUI to install only the SANsurfer Switch Manager GUI. This option is for managing Qlogic switches only. - iSCSI GUI and Agent to install the SANsurfer iSCSI HBA Manager GUI, including the iSCSI (Windows, Linux, or Solaris) agent. - SANsurfer iSCSI HBA Manager to install only the SANsurfer iSCSI HBA Manager (GUI, not the iSCSI (Windows, Linux, or Solaris) agent). 4. Qlogic SANsurfer installs in the /opt/QLogic_Corporation/SANsurfer. The launch script is located in the /usr directory. The qlremote is installed in the /usr/local/bin directory. Command Line Installation of Qlogic SANsurfer and the qlremote agent: 1. Open a shell and change to the directory that contains the Qlogic SANsurfer installer. 2. At the prompt, type the following command: sh ./sansurfer2.0.30b62_linux_install_amd64-i.bin -i silent -D SILENT_INSTALL_SET="QMSJ_G_LA" 3. Qlogic SANsurfer installs in the /opt/QLogic_Corporation/SANsurfer directory. The launch script is located in the /usr directory. The qlremote is installed in the /usr/local/bin directory. Command Line Installation of only the qlremote agent: 1. Open a shell and change to the directory that contains the Qlogic SANsurfer installer. 2. At the prompt, type the following command: sh ./sansurfer2.0.30b62_linux_install_amd64-i.bin -i silent -D SILENT_INSTALL_SET="QMSJ_LA" 3. Qlogic SANsurfer installs in the /opt/QLogic_Corporation/SANsurfer directory. The uninstall script is located in the /usr directory. The qlremote is installed in the /usr/local/bin directory. =================================================================== 6.0 RUNNING Qlogic SANsurfer ----------------------------- Once the application has been installed, launch it. Note: The default Qlogic SANsurfer password is "config". Make sure you change this password after installation to ensure that security is not compromised. To enter a new Password you must have Administrative Privileges. You cannot perform management functions and NVSRAM\Flash modification unless you set a Password for Qlogic SANsurfer. Note: Ensure that no I/O's are occurring when qlremote is running. Please refer to the online help file or the User's Guide for more information. To view the online help, go to Help and "Set Browser Location" to match the location where your preferred browser is located. Qlogic SANsurfer supports Netscape Communicator (version 4.5 or greater). You may now browse the Help file by selecting "Browse Contents". 1. Open a terminal windows and run: qlremote start 2. Open another terminal window and run: /usr/SANsurfer or SANsurfer. A Qlogic SANsurfer window displays. 3. A Qlogic SANsurfer coneection window displays. Connect to local host. Perform HBA diagnostic functions as required. Refer to the online help for information on how to use different features of the SANSurfer program. In addition, the DS4000 storage subsystem Problem Determination Guide also contains information on how to use the program to diagnose Fibre Channel path problems. This guide is available as a pdf file at the IBM DS4000 Technical Support web site. Running Storage Subsystem->Profile in the Subsystem Management window will display the world-wide port name for each controller. Ensure that the preferred path in the FAStT_MSJ LUN configuration window matches the controller assignment in IBM FAStT Storage manager. You can also configure LUNs to match the preferred paths shown in IBM FAStT/DS4000 storage manager and create a failover/failback configuration for the Qlogic Linux failover device driver if you are using the Linux failover device driver as DS4000 LUNs multipath driver. However, IBM is currently shipped the Linux RDAC multipath failover. This RDAC driver is the preferred multipath driver in Linux operating system environments and should be used as the DS4000 LUNs multipath driver in conjunction with the non-failover version of the Qlogic FC HBA Linux device driver . 4. Apply the configuration and exit Qlogic SANsurfer program. It might take up to a minute for Qlogic SANsurfer program to end. 5. To stop the qlremote service, type qlremote stop in the console window. Note: Steps 6 though 10 show what are needed to configure the FC HBA with the LUN failover/failback configuration data that is created in step 3. For up-to-date instructions, please refer to information in the Linux driver READMEs that are packaged with each IBM FAStT/DS400 Linux driver release. IMPORTANT: IBM is currently shipped the Linux RDAC multipath failover supporting DS4000 LUNs. This RDAC driver is the preferred multipath driver in Linux operating system environments and should be used as the DS4000 LUNs multipath driver in conjunction with the non- failover version of the Qlogic FC HBA Linux device driver. 6. In the terminal windows type: depmod -a 7. Unload the qla2200 or qla2300 driver and then reload the driver using modprobe so the driver will pull in the new option string that was added by FAStT_MSJ. 8. Type the following command: # mkinitrd -f NOTE: This step will overwrite the original ramdisk image file if executed within the /boot directory. Specify a unique ramdisk image name to preserve the original ramdisk image. - Copy the file to /boot. For SuSE Distribution: - Type the following command: # /sbin/mk_initrd NOTE: By default, the RAMDISK images created are: /boot/initrd /boot/initrd.suse 9. If you are using lilo, in a terminal window type: /sbin/lilo Otherwise you will not be able to boot your new ramdisk image. 10. Reboot the system to the ram disk image just created. =================================================================== 7.0 Uninstalling Qlogic SANsurfer ---------------------------- 7.1 Be sure to exit the Qlogic SANsurfer application before you uninstall Qlogic SANsurfer. 7.2 Change to the directory where you installed the Qlogic SANsurfer scripts. The default is /usr directory. cd /usr 7.3 Type the following to run the InstallAnywhere Uninstaller. sh ./SANsurfer_Uninstaller =================================================================== 8.0 LIMITATIONS ----------------- - The DS4000 storage products do not support the use of LUN masking or HBA configuration wizard/functions. In addition, The DS4000 storage products also do not support non-Fibre Channel HBA functions like Qlogic SANSwitch or iSCSI HBA functions. - If multiple NICs (Network Interface Cards) are present in the system, the Qlogic SANsurfer client will broadcast to the first IP address subnet based on the binding order. Therefore, ensure that the NIC for the local subnet is first in the binding order. If this is not done, the diagnostics might not run properly and remote connection might not occur. - The Qlogic SANsurfer application tries to help in not allowing the user to connect to the same host more than once (causes issues with policies and wasted system resources). This adds the requirement that all host IP address MUST resolve to a host name to allow connection to complete. - If DNS is not used you must edit the local host file on the systems where you are running the Qlogic SANsurfer GUI and the QLremote agent. Add the host name to IP mapping manually. Edit the file /etc/hosts. - If the system has the firewall installed this could cause issues with async alarms from the agent running on Linux to a remote machine. This could also occur if the GUI is running on a Linux Client talking to a remote machine. To circumvent this problem do the following at a shell prompt: chkconfig --list Verify that "ipchains and iptables" in run levels 2, 3, 4, 5" are disabled. to disable at a specific run level chkconfig --level 2 ipchains off chkconfig --level 3 ipchains off chkconfig --level 4 ipchains off chkconfig --level 5 ipchains off chkconfig --level 2 iptables off chkconfig --level 3 iptables off chkconfig --level 4 iptables off chkconfig --level 5 iptables off - When a FAStT/DS4000 Fibre Channel HBA (QL2200, 2310, 2340 or 2342) is connected to the Fabric (switch), Loopback test is disabled since the adapter is in a point to point mode. Unplugging the cable from the Fabric and inserting a wrap connector at the end of the cable (or at the adapter) will enable loopback test. - The Qlogic SANsurfer online web help can only be viewed by Netscape Communicator (version 4.5 or greater). - When an online device fails and goes offline and a subsequent configuration refresh occurs, the loop id for that device does not reflect the original ID since the device is in effect no longer in the loop (may show x100 or xff). - When a failure occurs during Diagnostics (Loopback test and Read/Write Buffer test) and the test is restarted immediately, MSJ may request whether or not you want to refresh the configuration. Select NO to continue the test. If YES is selected the Host may be disconnected with the following message: "Unable to connect to the Host: {Host Name / IP address}. The Host is currently in diagnostics mode, try again later." To recover, you need to stop (ctrl-c in the terminal session where you started qlremote) and then restart the agent "qlremote" ==================================================================== 9.0 WEB Sites and Support Phone Number ---------------------------------------- 9.1 IBM System Storage™ Disk Storage Systems Technical Support web site: http://www.ibm.com/servers/storage/support/disk/ 9.2 IBM System Storage™ Marketing Web Site: http://www.ibm.com/servers/storage/disk 9.3 You can receive hardware service through IBM Services or through your IBM reseller, if your reseller is authorized by IBM to provide warranty service. See http://www.ibm.com/planetwide/ for support telephone numbers, or in the U.S. and Canada, call 1-800-IBM-SERV (1- 800-426-7378). ==================================================================== 10.0 TRADEMARKS AND NOTICES ---------------------------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM System Storage the e-business logo xSeries, pSeries HelpCenter UNIX is a registered of The Open Group in the United States and other countries. Microsoft, Windows, and Windows NT are of Microsoft Corporation in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. QLogic and SANsurfer are trademarks of QLogic Corporation. Other company, product, or service names may be trademarks or service marks of others. ======================================================================= 11.0 Disclaimer -------------- 11.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. 11.2 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.