SANsurfer Fibre Channel (FC) HBA Manager

This software license applies only to QLogic customers.
QLogic Corporation.
All rights reserved.

Table of Contents

OS Support
Supported Features
Application Notes
Contacting Support

1. OS Support

The SANSurfer FC HBA Manager is available as OS-specific packages for Microsoft Windows, Red Hat Linux, Novell (SUSE) Linux, Sun Solaris, Apple Mac OS X, and Novell NetWare operating systems.

2. Supported Features

The SANSurfer FC HBA Manager provides a graphical user interface (GUI) that lets you easily install, configure, and deploy QLogic Fibre Channel HBAs.  It also provides robust diagnostic and troubleshooting capabilities and useful statistical information to optimize SAN performance.

3. Application Notes

  • For installation options and instructions, see the SANblade FC HBA Quick Start Guide, which you can download from
  • The default SANsurfer HBA Manager operation password is config.
    NOTE: Make sure to change this password after installation to ensure security.
  • To view the SANsurfer HBA Manager online web help, use one of the following browsers:
    • Internet Explorer (version 6.0 or greater)
    • Firefox (version 1.0 or greater)
    • Safari (version 1.3 or greater).
  • The SANsurfer HBA Manager application prevents the user from connecting to the same host more than once (to save system resources and address policy issues). This requires that all host IP addresses MUST resolve to a host name to allow the connection to complete.
  • If your system doesn't use DNS, you must edit the local host file on the system running the SANsurfer HBA Manager GUI and add the host name to IP mapping manually, as defined for your operating system:
    <install drive>:\\winnt\\system32\\drivers\\etc\\hosts

          NetWare (Windows System's NetWare client):
           <install drive>:\\winnt\\system32\\drivers\\etc\\hosts

  • In SANsurfer FC HBA Manager, the File Choosers don't always respond to a double-click traversal of the file system. When this happens, select the directory and click the Open button to traverse the directory or open a specific file.
  • Set the video resolution to a minimum of 800x600 with a color palette of at least 256 colors to run the SANsurfer HBA Manager GUI.
  • Uninstalling the software does not remove some files and directories. You must manually delete these files.
  • During SANsurfer FC HBA Manager installation, the system prompts you to select or deselect Enable Failover. When selected (default), failover tells the application how to create and validate the saved configurations. Selecting this option prevents the installation process from loading the platform-specific failover driver automatically.
  • Windows 2000 and Windows Server 2003 failover requires the driver registry parameters buschange=0 and FixupInquiry=1. You must add these parameters under the following registry keys:
    \\Parameters\\Device\\DriverParameters string value
  • A Windows installation uses the ConfigRequired driver registry parameter to dictate how devices are presented to the OS:
    • If ConfigRequired=0, both persistently bound and new devices show up as enabled. This includes devices that might have been previously unconfigured using the utility. You can set this parameter in the Driver Setting of SANsurfer HBA Manager called: "Present targets that are persistently bound plus any new target(s) found."
    • If ConfigRequired=1, only persistently bound devices show up as configured. New devices or devices that were previously unconfigured using the utility show up as unconfigured. You can set this parameter in the Driver Setting of SANsurfer HBA Manager called: "Present target that are persistently bound only."
  • NOTE: When using the new Windows driver (v8.2.0.10 and later), you must explicitly set the ConfigRequired parameter to 1 to prevent unconfigured entries from showing up to the OS.

  • The administrator account password must not be blank when changing the SANsurfer HBA Manager application password. This is a Windows Server 2003 security restriction.
  • Running SANsurfer HBA Manager on an Itanium I system hinders the application performance due to a Java compatibility issue. This issue is not seen with Itanium II systems.
  • When updating the Windows driver using the SANsurfer HBA Manager, the driver parameters revert back to their default values:
    • Present targets that are persistently bound plus any new target(s) found.
    • Bind By World Wide Port Name.
  • When performing a driver update on unsigned Windows drivers, the system displays a confirmation dialog box:
    • If you are performing the driver update on the localhost and the GUI is connected to localhost (non-agent), the dialog box appears in front of the application (focus).
    • If you are performing the driver update on the localhost and the GUI uses the host name or IP address to connect, the dialog box appears behind the GUI (no focus). To avoid this, you should perform a driver update on the local host, connected as localhost.
  • Targets attached to QLA200 adapter ports have the failover configuration disabled (Windows only). If the targets are shared on other adapter ports (non-QLA200), but the same host, failover is disabled on all paths of the shared target.
  • When connecting to a local host on Windows IA32 or Linux IA32, the system uses a DLL/shared library instead of the agent. Because there is no communication between the localhost version and the agent, you must use only one or the other, but not both at the same time.
  • When running SANsurfer HBA Manager and connecting to a remote RedHat Linux machine, you must modify the /etc/hosts files on the two machines to allow async notifications from the agent to the GUI to operate properly. To resolve this issue, create a new entry with the host IP address assigned to ethx. Modify the existing entry by moving the hostname from the locahost line to the newly created line.
  • Example
    Initial: localhost
    Modified: localhost

  • With Linux 7.x and Advanced Server 2.1, a new secure portmapper has been included. Add the statement portmap:ALL to the /etc/hosts.allow file to enable remote communication to work properly between GUIs and agents.
  • Before you can change the current SANsurfer HBA Manager password, you must shadow the password option installed on your Linux machine. For example on a Linux 7.2 platform, follow these steps to create the /etc/shadow file:
    1. Install shadow-utils rpm package from <Linux 7.2 CD-1> /RedHat/RPMS/shadow-utils-20000902-4.i386.rpm.
    2. Go to /etc and type the pwconv command to convert the passwords to shadow password format.
  • The Linux system displays the message Warning: Cannot convert string "x" to type VirtualBinding when running either the GUI or the uninstall; this is a Java issue where the specified key mapping are already defined by the window manager. You can ignore these warnings since they do not affect the operation of the application.
  • The string options qla2x00 ConfigRequired=1 ql2xuseextopts=1, resides in the /etc/modules file, even after you delete the Persistent Configuration. To completely delete any and all persistent data, you must manually edit this file.
  • When using the non-failover version of the Linux driver, disable failover by launching the Fibre Channel Port Configuration window and de-selecting the Enable Failover Configuration (host) selection under the File menu.
  • To run the IA32 SANsurfer FC HBA Manager installer under Linux x86_64 (EM64T), you must install the IA32 X11 libs. These libs are included in the xorg-x11-libs-<version>.EL rpm. If the libs are missing, the system displays the following exception:
  • java.lang.UnsatisfiedLinkError:
    /tmp/install.dir.4191/Linux/resource/jre/lib/ i386/xawt/ cannot open shared object file: No such file or directory

  • Why doesn't my hard drive show the correct size under LUN information?
  • The system uses two different measurement formats: decimal (GB), which is used by Windows and binary (GiB), which is used by Linux. Both Linux and Windows provide the "correct" number.

    • Binary numbers are based on a power of 2.
    • Decimal numbers are based on a power of 10. 2^10 is 1,024 the closest Decimal number is 10^3 or 1,000 2^20 is 1,048,576 The closest Decimal number is 10^6 or 1,000,000 2^30 is 1,073,741,824 The closest Decimal number is 10^9 or 1,000,000,000.
  • On Solaris, the qla_mp_config_required parameter in the registry dictates how devices would show up to the OS.
  • The qla_mp_config_required flag in the QLogic configuration file (qla2x00.conf) controls persistent binding of targets. The default configuration file that comes with the QLogic driver does not have an entry for this flag. An entry for this flag appears in the configuration file only when target configuration data is saved using SANsurfer HBA Manager.

    SANsurfer HBA Manager sets the qla_mp_config_required flag to 1 by default.

    • If qla_mp_config_required is set to 1, only target devices that are persistently bound in the configuration file are reported to the OS. Any new or unconfigured targets are not reported to the OS by the driver. In other words, the default behavior for this flag is persistent targets only.
    • If qla_mp_config_required is set to 0, both persistently bound and new targets are reported to the OS. This is equivalent to persistent plus new.

    NOTE: SANsurfer HBA Manager does not read in the value of the persistent-binding-configuration parameter from the configuration file.

  • On Solaris, you must stop the qlremote agent before using the Hot Swap feature on QLogic FC adapters. Please refer to the hardware manual for detailed instructions.
  • During normal operation of the SANsurfer FC HBA Manager applications on Solaris, a stale semephore left behind causes all applications to fail on load. To resolve the issue, you must manually remove these two files:
  • /var/tmp/.SEMD

  • Operating the SANsurfer HBA Manager on NetWare 5.x/6.x servers requires the IPX/SPX network protocol.
  • After completing installation of the Novell NetWare agent, you must start the SANsurfer HBA Manager agent using one of these methods:
    • Reboot the NetWare server on which you installed the agent.
    • On the console of the NetWare server where the agent resides, type the following command:
  • NOTE: This assumes you have already loaded the QLogic Novell NetWare HAM driver.

  • To run SANsurfer on NetWare, modify the FILES and BUFFERS defined in the boot drive's CONFIG.SYS file to the following settings:
  • FILES = 100
    BUFFERS = 50

  • When uninstalling the SANsurfer HBA Manager from a NetWare server, the server's prompt displays the following message: Cannot stat sys:etc/rpcnet.cfg.
  • NOTE: You can ignore this message since it does not affect the NetWare server's operation.

  • Mac OS X has a bug that affects SANsurfer installer on OS X 10.3.9 systems with the QuickTime 7.0.4 upgrade. This appears to only affects systems running 10.3.9, and not 10.4. The current workaround is to revert to QuickTime 7.0.1, through a reinstaller available from Apple on the Support/Downloads page. 36.
  • After updating to Mac OS X 10.3.9, SANsurfer does not install and start. SANsurfer is a Java application and is affected by this Java issue. Review article: ?artnum=301380

4. Contacting Support

Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods:


North America Contact Information
Phone: (952) 932-4040

Support contact information for other regions of the world is available at the QLogic website:

Go to Top