SANsurfer Pro Application Notes. Table of Contents

Transcription

1 SANsurfer Pro Application Notes This software license applies only to QLogic customers. QLogic Corporation. All rights reserved. Table of Contents 1. SANsurfer FC HBA Manager Application Notes (Fibre Channel HBA QLA2XXX) 2. SANsurfer Switch Manager Application Notes 3. SANsurfer iscsi HBA ManagerApplication Notes (iscsi HBA QLA4xxx) 3.1. SANsurfer iscsi HBA Manager Notes 3.2. SANsurfer iscsi HBA Manager Known Issues & Work Arounds 4. Contacting QLogic 1. SANsurfer FC HBA Manager Application Notes (Fibre Channel HBA QLA2XXX) For installation options and instructions, see the SANsurfer HBA Manager User's Guide. 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: Windows: <install drive>:\\winnt\\system32\\drivers\\etc\\hosts Linux: /etc/hosts

2 Macintosh: /etc/hosts Solaris: /etc/hosts NetWare (Windows System's NetWare client): <install drive>:\\winnt\\system32\\drivers\\etc\\hosts In SANsurfer Pro, 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 Pro 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: \\HKEY_LOCAL_MACHINE\\SYSTEM \\CurrentControlSet\\Services\\ql2300 \\Parameters\\Device\\DriverParameters string value A Windows installation uses the ConfigRequired driver registry parameter to dictate how devices are presented to the O/S: 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 (v 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.

3 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 runner.domain.com Modified: localhost runner.domain.com 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 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.

4 To run the IA32 SANsurfer Pro 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/libmawt.so: libxext.so.6: 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 Pro 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 /var/tmp/.seml 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: RPCSTART LOAD QLREMOTE.NLM NOTE: This assumes you have already loaded the QLogic Novell NetWare HAM driver.

5 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. 2. SANsurfer Switch Manager Application Notes SANbox firmware version 4.1 must be used in conjunction with SANsurfer Switch Manager and SANsurfer Performance Viewer. If you are upgrading a SANbox2 switch from a firmware version prior to 2.0, please consult the 2.0 release notes for upgrade information or contact QLogic Technical Support for assistance. CAUTION: Before downgrading to 1.3, back up the configuration. Downgrading SANbox2 firmware to 1.3.xx causes configuration data loss and the system flashes a 4-blink code on the Heartbeat LED. Visit the knowledge base section of our web site at or contact QLogic Technical Support for assistance. If you need to downgrade from 4.0 firmware to 3.0 firmware on a SANbox switch, please contact your QLogic approved reseller or QLogic Technical Support as noted in Contacting QLogic. When launching SANsurfer Switch Manager, the system might display an error message regarding your font settings such as "Cannot convert string monotype arial regular..." This is a configuration issue with the X Window System and does not affect the functionality of the GUI. The font path of the machine whose X- server is displaying the application needs to have a directory which either has the specified font (Arial) or a font alias to re-map it to another font. To overcome this, you could use the sdtfontadm utility at the root to add the /usr/openwin/lib/x11/ TrueType directory to the font path on the machine that is displaying SANsurfer Switch Manager (not the machine on which the application is executing). When running from a remote login, the font size used for the text in the Help file is too small to read. This is an X Window font configuration issue. Edit (or create) an.xdefaults file in your home dir (/ for root) and put the following lines in it: Netscape*documentFonts.xResolution*iso : 100 Netscape*documentFonts.yResolution*iso : 100 While these changes may provide a solution, in some cases it may not. In such cases, could resolve the small font size by modifying the font preferences in Netscape to Use my default fonts, overriding document specified fonts. If you execute SANsurfer Switch Manager on a UNIX system, put it in the background (SANsurfer_Switch_Manager &). Closing that window or terminal session kills the SANsurfer Switch Manager; therefore, do not run the SANsurfer Switch Manager as a background process if that window will later be closed. In the Network Properties dialog box, if you enter certain types of invalid IP addresses, Java may accept it and display it as a different address than what you entered. Entering valid IP addresses works correctly.

6 In the unusual case where changing the fabric causes the GUI to add or remove an item from an open menu, it might not be redrawn completely. To correct the problem, close and re-open the menu, or perform any other menu operation. In the SANsurfer Performance Viewer, maximizing multiple graphs may increase CPU utilization to 100%. To work around this issue, reduce the size of the graphs or increase the polling frequency in the Graphics -> Set Polling Frequency menu item. While running the embedded applet, if you change the IP address of the switch where the embedded applet resides, the embedded applet session (at the old IP address) will stop responding. To work around this issue, specify the new IP address for the embedded applet in a new browser window. 3. SANsurfer iscsi HBA ManagerApplication Notes (iscsi HBA QLA4xxx) 3.1. SANsurfer iscsi HBA Manager Notes For information on application instructions and options, review the application help by starting within the application or use a web browser to view the help file located in folders shown for your operating system: Windows: <install directory>\help\iscsi_help\iscsi_help.htm Unix: <install directory>/help/iscsi_help/iscsi_help.htm If the Target Settings Tab shows targets discovered by configuring a SendTargets host, you must delete the SendTargets host when deleting any of the targets to prevent them from reappearing on the next reset of the adapter. The default SANsurfer HBA Manager operation password is config. NOTE: Make sure to change this password after installation to ensure security. Changing the password requires the following for each platform: Windows: Username specified must be for an account in the administrator group on the system in which the agent is running. Linux: Username specified must be an account in both the adm and root groups on the system in which the agent is running. Currently there is a separate password setting in Non-Agent mode and Agent mode per host. Therefore changing one will not change the other. Before you can change the current SANblade Manager password, you need the shadow password option installed on your Linux machine. For example, on a Red Hat Linux, follow these steps to create /etc/shadow file: 1. Install shadow-utils rpm package from <Linux CD-1>/RedHat/RPMS/shadow-utils i386.rpm. 2. Go to /etc and type the pwconv command to convert the passwords to shadow password format. The administrator account password must not be blank when changing the SANblade Manager application password. This is a Windows 2003 security restriction. The SANsurfer iscsi 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 address MUST resolve to a host name to allow the connection to complete.

7 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: Windows: <SystemRoot>\\system32\\drivers\\etc\\hosts Linux: /etc/hosts Solaris: /etc/hosts When running SANsurfer iscsi HBA Manager and connecting to a remote 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 localhost line to the newly created line. For example: Initial: localhost runner.domain.com Modified: localhost runner.domain.com With Linux a new secure portmapper has been included. Add the statement portmap : ALL to the /etc/ hosts.allow file for remote communication to work properly between GUIs and agents. On systems where DNS is not set up properly and where there are no entries in the system hosts file for the hosts where SANsurfer iscsi HBA Manager iqagent is installed, host status alarms may not update the client GUI properly. The iscsi HBAs and iscsi HBA Driver must be correctly installed before the SANsurfer iscsi HBA Manager agent (iqlremote) can start successfully. If a system has multiple HBAs, and BIOS is desired, it is important to insure that ALL HBAs have firmware that supports BIOS. Fast!UTIL does not restrict configuration of HBAs that do not have current firmware. If the DHCP server is unavailable, it is recommended that the HBA be set to a fixed IP address. On Windows, if the above process does not work, you must disconnect the HBA network link must prior to updating to the fixed IP address, and then reconnect it after reconfiguring the HBA with the new IP Address. HBAs installed on Windows systems use a global Keep Alive Time Out per HBA. Individual target Keep Alive Time Out settings of targets on each HBA are ignored. Configure the HBA Global Keep Alive Time Out under HBA Options tab, Firmware sub tab, under the Configured Firmware Values. In rare cases, you must issue a manual Refresh more than once to update the display correctly. If a prompt appears, requesting you to disconnect from host, answer no and continue to wait for refresh to complete. Targets that do not have their bind flag set will not persist across save operations. All Targets that you wish to persist across save operations must have the bind flag set. TCP Timestamp should not be disabled in the firmware options to preserve full functionality.

8 Under Linux x64 (EM64T, AMD64), the IA32 SANsurfer Pro installer requires installation of the IA32 X11 libs and either the Compatible Architecture Development or the Compatible Architecture Support package. The IA32 X11 libs are included in the xorg-x11-libs-<version>.i386.el rpm. If the libs are missing the following exception will be displayed: java.lang.unsatisfiedlinkerror: /tmp/install.dir.4191/linux/resource/jre/lib/ i386/xawt/ libmawt.so: libxext.so.6: cannot open shared object file: No such file or directory For example, an installation package with its dependent packages for the 2nd Red Hat install disk includes: xorg-x11-libs el.i386.rpm xorg-x11-mesa-libgl el.i386.rpm expat i386.rpm fontconfig i386.rpm freetype i386.rpm zlib i386.rpm On the Solaris 10 operating system, you must set the web browser location for online help needs to a location of an installed web browser. The default for Solaris 10 is: /usr/sfw/bin/mozilla In rare cases, when you restart the system in agent mode, the agent starts when the driver is still loading and not all HBAs are discovered initially. Refreshing the host on the GUI discovers any HBAs that the driver has presented since the initial startup of the agent or since the last refresh. SANsurfer iscsi HBA Manager does not support agent mode on systems that use the iscsi HBA NDIS (network) driver. For these systems, install only the GUI portion of SANsurfer iscsi HBA Manager on the local system, not the agent. In this configuration, the GUI communicates directly with the locally installed iscsi HBAs without an agent. The isns and SLP automatic target discovery process is a continuous discovery process. Targets do not always appear immediately after the features are enabled. Refreshing the HBAs on the host checks for currently discovered targets or, if wait 30 seconds to 2 minutes, the SANsurfer iscsi HBA Manager GUI automatically detects newly discovered targets and requests a refresh to update the information displayed in the GUI. To update the MTU/Jumbo Frames parameter on a 405x HBA and if the iscsi HBA NDIS (network) driver is installed, you must configure the MTU/Jumbo Frames parameter must using the SANsurfer iscsi HBA Manager, then reboot the system to ensure that the operating system uses the updated MTU value for the newtwork and NDIS drivers as well as the iscsi driver.

9 3.2. SANsurfer iscsi HBA Manager Known Issues & Work Arounds Issue / Problem Description When changing the HBA port subnet for systems using DHCP, you need to reset the DHCP option on GUI for to acquire new lease for a QLA4xxx. If the DHCP Server has a long lease time, the system does not acquire a new lease in a reasonable amount of time. The File Choosers in SANsurfer HBA Manager at times do not respond to double-click traversal of the file system. If multiple targets with an active session are deleted or a session is lost (for example by entering invalid CHAP entries), saving the HBA settings may fail. Disabling a Send Targets entry in the HBA Target Settings tab, generates invalid error messages: RPC Error or Save Target Settings Failed when performing a save. The save operation actually completes successfully. Work Around / Solution Reset the 40xx using the HBA level Options tab by clicking the Reset button. This resets the board and issues a new IP address. Select the directory and click the Open button to the right to navigate the directory or open a specific file. Delete or log out from targets one at a time if this occurs. To eliminate these invalid error messages, re-enable the Send Targets entry and save it or remove the Send Targets entry. The value displayed for MACEncodingErrorCount in the Statistics tab is not correct. Non-Agent Mode: In rare cases, if you select Refresh at a specific time during HostPolling, the display bar continues to show a refresh. Disconnect and Re-Connect to the host. During installation, if you select the option to remove a prior installed version of the application, then at times the uninstaller windows hide behind the current installation windows. When deleting and saving dynamic targets (ID >= 64) to persistent targets (ID < 64) without saving target settings between delete and save operations, any dynamic targets saved before deleting persistent target IDs will not persist across OS reboots. In rare cases when SANsurfer iscsi agent is busy, a Possible Loss of Communication popup window appears. Recommend the the popup be answered to not disconnect. In rare cases when using non-agent mode, SANsurfer iscsi may frequently request a refresh when none are needed. Under Target Settings tab, select Save Settings first to save all dynamic targets to persistent, then delete targets, and do a final Save Settings. Respond not to disconnect. Change the host polling interval to a larger value or turn off by setting it to zero. When performing a selective restore of firmware defaults (even when network parameters are not selected for default), the SLP DA address resets to Contacting QLogic Please visit QLogic's website ( On this site you will find product information, our latest drivers, and links for technical assistance if needed. Go to Top

10 Copyright All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are registered trademarks of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners.