Q Simplify SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters FS0054603-00 C Page i
Q SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters Information furnished in this manual is believed to be accurate and reliable. However, QLogic® Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice.
Q SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters Revised software requirements: Added Windows 2000 SP4 support Removed Windows 2000 SP1, SP2, and SP3 support Removed Windows NT support Added Red Hat Linux, SuSE Linux, and Solaris SPARC support All Revised component level install and uninstall. 5 Added automatic alarm notification by email (SMTP only). 6.11, 8.2.
SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters Q © 2001–2004 QLogic Corporation. All rights reserved worldwide. First Published: March 2001 Printed in U.S.A.
Table of Contents Section 1 Introduction Section 2 System Overview 2.1 2.2 2.2.1 2.2.1.1 2.2.1.2 2.2.2 2.2.3 2.2.4 2.2.5 2.2.6 2.3 2.3.1 2.3.1.1 2.3.1.2 2.3.2 2.4 2.4.1 2.4.1.1 2.4.1.2 2.4.1.3 2.4.1.4 2.4.2 2.4.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1: Collect the Hardware and Software . . . . . . . . . . . . . . . . . .
SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters Q Section 5 Installing SANsurfer FC HBA Manager 5.1 5.1.1 5.1.2 5.2 Initial Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Q 7.2 7.3 7.4 7.4.1 7.4.1.1 SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters SANsurfer FC HBA Manager 7.9 7.9.1 7.9.2 7.10 7.10.1 7.10.2 7.11 7.11.1 7.11.2 7.12 7.13 Configuring HBA Ports Using the General Configuration Wizard . . . . . . . Configuring LUN Masking Using the LUN Masking Wizard . . . . . . . . . . . Configuring Fibre Channel Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters 8.2.2 8.2.3 8.2.4 8.2.5 Q Clearing the Alarm Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exporting the Alarm Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printing the Alarm Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing an Alarm Notification Received by Email . . . . . . . . . . .
Q SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters SANsurfer FC HBA Manager Section 11 Updating the HBA 11.1 11.1.1 11.1.2 11.1.3 11.2 11.3 11.4 11.5 11.6 Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HBA Port Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters Q Figures Figure 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-8 5-9 5-10 5-11 5-12 5-13 5-14 5-15 5-16 5-17 6-1 6-2 6-3 6-4 6-5 6-6 6-7 6-8 6-9 6-10 6-11 6-12 7-1 7-2 7-3 7-4 7-5 7-6 7-7 7-8 Page x Page Installation Introduction Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Important Information Dialog Box . . . . . . . . . . . . . . . . . . . . . . .
Q 7-9 7-10 7-11 7-12 7-13 7-14 7-15 7-16 7-17 7-18 7-19 7-20 7-21 7-22 7-23 7-24 7-25 7-26 8-1 8-2 8-3 8-4 8-5 8-6 8-7 8-8 8-9 8-10 9-1 9-2 9-3 9-4 9-5 9-6 9-7 9-8 9-9 9-10 9-11 SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters SANsurfer FC HBA Manager Finish Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Device Selection Dialog Box . . . . . . . . . . . . . . . .
SANsurfer FC HBA Manager Application User’s Guide for OEMs Management Application for SANblade Fibre Channel Host Bus Adapters 9-12 9-13 10-1 10-2 10-3 10-4 10-5 11-1 11-2 11-3 11-4 11-5 11-6 11-7 11-8 11-9 11-10 11-11 11-12 11-13 11-14 11-15 12-1 12-2 12-3 Q LUN List Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LUN Information Tabbed Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Section 1 Introduction The SANsurfer FC HBA Manager Application User’s Guide for OEMs describes SANsurfer® FC HBA Manager, an application that allows you to configure and manage devices in a storage area network (SAN) environment that uses QLogic® Fibre Channel host bus adapters (HBAs). The contents of this user’s guide are described in the following paragraphs: ■ Section 1—Introduction. This section summarizes the contents of this user’s guide. ■ Section 2—System Overview.
Q 1 – Introduction Related Documents ■ Section 12—Troubleshooting. This section presents common troubleshooting questions and answers. It also provides the procedures for tracing SANsurfer FC HBA Manager GUI and agent activity, if directed to do so by technical support. ■ Appendix A—Frequently Asked Questions. This appendix lists and provides the answers to frequently asked questions about SANsurfer FC HBA Manager. ■ Appendix B—Glossary.
Section 2 System Overview 2.1 Introduction SANsurfer FC HBA Manager is a collection of device drivers and management software for controlling, configuring, and managing devices in a storage area network (SAN) environment that uses QLogic Fibre Channel (FC) host bus adapters (HBAs). This section summarizes information from various products and contains an installation checklist. The contents of this section are summarized in the following paragraphs: ■ Section 2.1—Introduction ■ Section 2.
Q 2 – System Overview Installation Checklist 2.2 Installation Checklist This section describes the installation process step-by-step. Note that your configuration may not require all steps, depending on the features you require. 2.2.1 Step 1: Collect the Hardware and Software 2.2.1.1 Required Hardware Collect the required hardware. In all cases, some combination of the following is required: ■ QLogic HBAs ■ Target devices such as disks, RAID subsystems, etc.
Q 2 – System Overview Installation Checklist 2.2.2 Step 2: Install the Hardware Refer to hardware installation guides to install HBAs in host systems (see section 1.1). Cable target devices through the combination of local loops, hubs, and switches in your configuration. Verification Before installing the device driver, verify the presence of HBAs at power up using the QLogic Fast!UTIL FC HBA BIOS utility. Type ALT+Q or CTRL+Q during power up to enter Fast!UTIL.
Q 2 – System Overview Installation Checklist 2.2.4 Step 4: Install and Run the SANsurfer FC HBA Manager SANsurfer FC HBA Manager is a management utility to view, manage, and diagnose QLogic HBAs. SANsurfer FC HBA Manager also configures HBAs, target devices on HBAs, and LUNs on target devices. To use the target masking and LUN masking features of SANsurfer FC HBA Manager, you must install SANsurfer FC HBA Manager. See section 5 for complete installation instructions.
Q 2 – System Overview Troubleshooting 2.3 Configuration Parameters 2.3.1 Linux Enhanced Driver Parameters 2.3.1.1 Basic Parameters QLogic configuration parameters are stored in the modules.conf file in the subdirectory /etc. Values of parameters in the file are found in the readme.txt file associated with the enhanced driver. 2.3.1.
2 – System Overview Troubleshooting Q 2.4.1.1 Windows Event Log The Windows event log is the main source of information for device driver problems and events. Device drivers usually indicate only status by logging events in the system event log. SANsurfer FC HBA Manager agents also use the application event log to report service errors, etc. For more information, see section 8.1. The miniport driver logs events for significant driver errors.
Q 2 – System Overview Troubleshooting event logging flag is stored in the HBA NVRAM and can be modified using Fast!UTIL or SANsurfer FC HBA Manager. The path for the Solaris messages file is /var/adm/messages. 2.4.1.4 SANsurfer FC HBA Manager SANsurfer FC HBA Manager displays target devices on an HBA, loop topology information, loop error count information, etc. SANsurfer FC HBA Manager displays target devices on an HBA and is useful for analyzing system configurations.
2 – System Overview Troubleshooting Q Notes 2-8 FS0054603-00 C
Section 3 SANsurfer FC HBA Manager Overview 3.1 What is SANsurfer FC HBA Manager? The QLogic SANsurfer FC HBA Manager is a GUI-based application that configures and manages QLogic Fibre Channel host bus adapters (HBAs) and attached devices within a storage area network (SAN) environment. Note the following: ■ SANsurfer FC HBA Manager works with the Windows 2000, Windows Server 2003, Red Hat Linux, SuSE Linux Enterprise Server 8, Solaris SPARC, and Novell® NetWare® operating systems.
3 – SANsurfer FC HBA Manager Overview Features ■ Statistics. SANsurfer FC HBA Manager provides statistics for each HBA port. These statistics can be collected automatically or on request. They can be reset at any time. In addition, you can export the statistics to a comma separated values (CSV) file that can be imported into other applications, for example, Microsoft® Excel. ■ Diagnostics.
Section 4 System Requirements The SANsurfer FC HBA Manager application requires the hardware and software listed in this section for optimum performance. 4.1 Hardware Requirements The minimum hardware requirements are as follows: ■ QLogic QLA200/QLA2xxx PCI to Fibre Channel HBAs (see section 4.
Q 4 – System Requirements Software Requirements 4.2 Software Requirements The minimum software requirements are as follows: ■ One of the following operating systems: ❑ Windows 2000 Server, Advanced Server, or Professional (SP4) ❑ Windows Server 2003 Standard Edition or Enterprise Edition ❑ Red Hat Linux 9 Professional (IA32) (kernel 2.4.20-18.9) or Red Hat Enterprise Linux Advanced Server (AS) 2.1 or 3.0 (IA32) (kernel 2.4.9.e-8) ❑ SuSE Linux Enterprise Server 8 (SLES) (IA32) (kernel 2.4.
Q 4 – System Requirements Supported QLogic HBAs 4.3 Supported QLogic HBAs The QLogic HBAs are collectively referred to as the QLA200/QLA2xxx HBA unless otherwise noted.
4 – System Requirements Supported QLogic HBAs Q Notes 4-4 FS0054603-00 C
Section 5 Installing SANsurfer FC HBA Manager Installing the SANsurfer FC HBA Manager consists of installing the SANsurfer FC HBA Manager GUI, platform-specific agent, and help components, as appropriate. NOTE: Before installing SANsurfer FC HBA Manager, read and follow the instructions in the documents listed in section 1.1, as applicable. This section discusses: ■ ■ Initial installation (see section 5.1) Uninstalling the SANsurfer FC HBA Manager application (see section 5.2) 5.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation 5.1.1 Installation Options SANsurfer FC HBA Manager supports both stand-alone and networked configurations. Install the software appropriate for your configuration (see table 5-1). Table 5-1. Configuration Option Installation Requirements Configuration Software Requirements Stand-alone system This Windows 2000/Windows Server 2003 or Red Hat/SuSE Linux system monitors QLA200/QLA2xxx HBAs locally.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation 5.1.2 Installation Instructions SANsurfer installer is a self-extracting program that installs the SANsurfer FC HBA Manager application and related software. NOTE: If a previous version of SANsurfer FC HBA Manager (or SANblade Manager) exists, uninstall it before proceeding.
5 – Installing SANsurfer FC HBA Manager Initial Installation Q b. Do one of the following to select and start the installation file. install is the SANsurfer installer file. ❑ For a Windows 2000/Windows Server 2003 system, locate the folder where you downloaded the install file and double-click the file. ❑ For a Red Hat/SuSE Linux or Solaris SPARC system, do the following: (1) Open a shell. (2) Change to the directory where you downloaded the SANsurfer installer.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation 3. The Important Information dialog box displays (see figure 5-2). Read the information, then click Next. Figure 5-2. Important Information Dialog Box You can find this information in the readme.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation 4. The Choose Product Features dialog box displays. See figure 5-3 for a sample dialog box. NOTE: Except for the agents that are installed, the feature options are the same for Windows 2000/Windows Server 2003, Red Hat/SuSE Linux, and Solaris SPARC systems.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation ❑ ❑ ❑ ❑ Select SFCHM GUI to install only the SANsurfer FC HBA Manager GUI. ❑ Select SANsurfer NetWare 4.2 Agent to install only the SANsurfer FC HBA Manager Novell Netware 4.2 agent. For a Red Hat/SuSE Linux system, select one preconfigured installation set from the following. Then click Next. ❑ Select SFCHM GUI and Agent to install the SANsurfer FC HBA Manager GUI, including the SANsurfer FC HBA Manager Linux agent.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation Perform the following steps to create a custom set: a. In the Install Set box, select Custom. b. Select from the following components: For a Windows 2000/Windows Server 2003 system: ❑ ❑ ❑ ❑ ❑ SANsurfer FC HBA Manager GUI SANsurfer Windows NT/2000/2003 Agent SANsurfer NetWare 4.2 Agent SANsurfer NetWare 5/6.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation Do one of the following: NOTE: ❑ For NetWare, select the drive mapped to the NetWare server (always select a location other than the default). To select the destination location displayed in the dialog box, click Next (recommended).
5 – Installing SANsurfer FC HBA Manager Initial Installation Q Application shortcuts consist of the following: ❑ The SANsurfer icon on the desktop (if selected in step 7) ❑ QLogic Management Suite (SANsurfer and SANsurfer Uninstaller), which is accessible when you click the Start button and point to Programs. Perform the following steps: a. Do one of the following: ❑ Click All Users Profile if you want the application shortcuts available to all users.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation Do the following: a. Select the Create Desktop Icon check box (default) if you want the SANsurfer icon to display on the desktop. b. Click Next. NOTE: If you select the Create Desktop Icon check box, the SANsurfer icon displays for the current user profile or all user profiles, depending upon your selection in step 6. 8. The Pre-Installation Summary dialog box displays (see figure 5-8). Review the information.
5 – Installing SANsurfer FC HBA Manager Initial Installation Q 9. The Installing SANsurfer dialog box displays (see figure 5-9). Various screens inform you that the installation is progressing. Figure 5-9. Installing SANsurfer Dialog Box 10. If you are installing NetWare, the Novell NetWare Disk Selection dialog box displays (see figure 5-10). Figure 5-10.
Q 5 – Installing SANsurfer FC HBA Manager Initial Installation A list of the autodetected Windows 2000/Windows Server 2003 drives mapped to NetWare server system volumes (sys:\) displays. Perform the following steps to select the Windows 2000/Windows Server 2003 drives on which to install the NetWare agent. Each drive must be mapped to a NetWare server system volume (sys:\). a. As appropriate, select one or more autodetected drives.
Q 5 – Installing SANsurfer FC HBA Manager Uninstalling the SANsurfer Application 5.2 Uninstalling the SANsurfer Application Perform the following steps to uninstall the SANsurfer FC HBA Manager or specific features from this system. Be sure to exit SANsurfer FC HBA Manager before you uninstall any of the SANsurfer FC HBA Manager application features. NOTE: If you are uninstalling Netware, note the following.
Q 5 – Installing SANsurfer FC HBA Manager Uninstalling the SANsurfer Application d. Select SANsurfer FC HBA Manager Vx.x.xx e. Click Change/Remove.
Q 5 – Installing SANsurfer FC HBA Manager Uninstalling the SANsurfer Application 3. The Uninstall Options dialog box displays (see figure 5-14). Figure 5-14. Uninstall Options Dialog Box You can uninstall the entire SANsurfer FC HBA Manager application or specific features. Do one of the following: 5-16 ❑ Select Complete Uninstall to remove all features and components of the SANsurfer FC HBA Manager application that were installed by InstallAnywhere.
Q 5 – Installing SANsurfer FC HBA Manager Uninstalling the SANsurfer Application Figure 5-15. Choose Product Features Dialog Box (Sample) a. Clear the check boxes of features that you want to uninstall. (Check boxes that are selected remain installed). Select from the following components (all components may not display and the order of the components may vary): For a Windows 2000/Windows Server 2003 system: ❑ ❑ ❑ ❑ ❑ SANsurfer FC HBA Manager SANsurfer Windows NT 4/2000/2003 Agent SANsurfer NetWare 5/6.
5 – Installing SANsurfer FC HBA Manager Uninstalling the SANsurfer Application Q 4. The Uninstall Component List dialog box lists the components to be uninstalled (see figure 5-16). Figure 5-16. Uninstall Component List Dialog Box A message displays asking you to wait the while the uninstaller removes the components. 5. The Uninstall Complete dialog box informs you that the uninstall is complete (see figure 5-17). Click Done. Figure 5-17.
Q 5 – Installing SANsurfer FC HBA Manager Uninstalling the SANsurfer Application 6. If any items were not successfully uninstalled, remove them. Some files and directories remain after uninstalling SANsurfer FC HBA Manager. These components must be deleted manually from the computer’s hard disk where SANsurfer FC HBA Manager was installed.
5 – Installing SANsurfer FC HBA Manager Uninstalling the SANsurfer Application Q Notes 5-20 FS0054603-00 C
Section 6 Getting Started This section includes the procedures for starting the SANsurfer FC HBA Manager GUI, exiting the SANsurfer FC HBA Manager GUI, and customizing the application options and policies. This section discusses: ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ Starting the SANsurfer FC HBA Manager GUI (see section 6.1) SANsurfer FC HBA Manager main window (see section 6.2) Exiting the SANsurfer FC HBA Manager GUI (see section 6.3) Getting help (see section 6.
Q 6 – Getting Started Starting the SANsurfer FC HBA Manager GUI 6.1.1 Starting SANsurfer FC HBA Manager on Windows 2000/ Windows Server 2003 On a Windows 2000/Windows Server 2003 system, do one of the following to start the SANsurfer FC HBA Manager. When done, the SANsurfer FC HBA Manager GUI displays (see section 6.2). ■ Double-click the SANsurfer icon on your desktop (if the icon was created during installation) (see figure 6-1).
Q 6 – Getting Started SANsurfer FC HBA Manager Main Window 6.2 SANsurfer FC HBA Manager Main Window When the SANsurfer FC HBA Manager GUI starts, SANsurfer: SANsurfer FC HBA Manager OEMID65 Version displays in the title bar and FC HBA displays on the application tab. Connect to the host (see section 7.1). The SANsurfer FC HBA Manager main window displays (see figure 6-2). Title Bar Tabbed Pages Menu Bar Toolbar Application Tab HBA Tree Status Line Figure 6-2.
6 – Getting Started SANsurfer FC HBA Manager Main Window Q The HBA tree contains the following visual indicators: Host icons and text. The HBA tree displays the following: ■ ■ Host status: live or offline Host name: host name or IP address Example: hostname 10.3.13.90 The icons are: ■ ■ Live (online) host. The blinking heart on the host icon indicates that the connection between the GUI and the agent is active for this host. Offline host. The configuration was loaded from a file (see section 7.11).
Q 6 – Getting Started SANsurfer FC HBA Manager Main Window HBA port icons and text. The HBA tree displays the following information: ■ HBA port number (Port n) ■ HBA port alias (if assigned) (see section 9.3) ■ Beacon flashing: Flash HBA Port Beacon is enabled (see section 10.1.1) ■ HBA status: the most severe displays—bad alarm, loop down, warning alarm, or good (no alarm). For information about alarms, see section 8.2.
Q 6 – Getting Started Exiting the SANsurfer FC HBA Manager GUI Examples: Disk (50-06-0E-83-00-00-2B-21):Online, Diag Disabled Disk (21-00-00-04-CF-92-7A-B1):Online, Diag Enabled Tape (10-00-00-04-32-72-06-64):Inactive, Diag Disabled The disk icons are: ■ ■ ■ ■ ■ Disk Online, Diag Enabled Disk Online, Diag Disabled Disk Inactive, Diag Enabled Disk Inactive, Diag Disabled Offline.
Q 6 – Getting Started Getting Help with the SANsurfer FC HBA Manager GUI 6.4 Getting Help with the SANsurfer FC HBA Manager GUI This section discusses: ■ ■ ■ Viewing online help (see section 6.4.1) Specifying the browser location (see section 6.4.2) Viewing SANsurfer FC HBA Manager software information (see section 6.4.3) 6.4.1 Viewing Online Help On the SANsurfer FC HBA Manager main window Help menu, click Browse Contents to view the online help. The help window displays. 6.4.
Q 6 – Getting Started Setting SANsurfer FC HBA Manager Security 6.4.3 Viewing SANsurfer FC HBA Manager Software Information To view information about the SANsurfer FC HBA Manager software, on the SANsurfer FC HBA Manager main window Help menu, click About. The About SANsurfer FC HBA Manager window displays (see figure 6-4). Figure 6-4.
Q 6 – Getting Started Setting SANsurfer FC HBA Manager Security ■ ■ LUN configuration Password (when you want it changed) You can change the SANsurfer FC HBA Manager access password for any host connected to your system for which you have administrator or root privileges. NOTE: The default SANsurfer FC HBA Manager access password is config. Change this password after installation to ensure that security is not compromised.
Q 6 – Getting Started Setting the Warning Display Option 4. In the Application Access section, do the following to modify the SANsurfer FC HBA Manager access password: a. In the Old Password box, type the current password. b. In the New Password box, type the new password. c. In the Verify Password box, type the new password again to confirm the new password. 5. Do one of the following: ❑ Click Apply to update the application access password.
Q 6 – Getting Started Setting the Configuration Change Alarm Option 2. In the Warning Displays section, do one of the following: ❑ Select the Enable Warning Displays check box if you want the warning dialog boxes to display. ❑ Clear the Enable Warning Displays check box if you do not want the warning dialog boxes to display. This is the default. 3. Click OK to return to the SANsurfer FC HBA Manager main window. 6.
6 – Getting Started Setting the Configuration Change Alarm Option Q 2. In the Configuration Change Alarm section, do one of the following: ❑ Select Apply Configuration Changes Automatically to have the SANsurfer FC HBA Manager GUI automatically update to the new configuration. If another host has made configuration changes that need to be updated in this configuration, the configuration change—reloading message displays. Click OK.
Q 6 – Getting Started Specifying the Polling Interval 6.8 Specifying the Polling Interval The polling interval is set on a host basis. The polling interval is the length of time between polls to a connected host to retrieve information. The SANsurfer FC HBA Manager main window HBA tree refreshes automatically based on this rate. NOTE: If you want to update the HBA tree immediately, click the Refresh button on the toolbar. Perform the following steps to set a host’s polling interval: 1.
Q 6 – Getting Started Setting the Event Log Options 6.9 Setting the Event Log Options Perform the following steps to set the number of events the event log can list and the logging of informational and warning events. NOTE: See section 8.1 for information about viewing the event log. 1. Do one of the following: ❑ On the SANsurfer FC HBA Manager main window Settings menu, select Options. ❑ Right-click the HBA tree. From the pop-up menu, click Options. ❑ Press CTRL+SHIFT+O.
Q 6 – Getting Started Setting the Alarm Log Option 6.10 Setting the Alarm Log Option Perform the following steps to set the number of alarms the alarm log can list. NOTE: See section 8.2 for information about viewing the alarm log. 1. Do one of the following: ❑ On the SANsurfer FC HBA Manager main window Settings menu, select Options. ❑ Right-click the HBA tree. From the pop-up menu, click Options. ❑ Press CTRL+SHIFT+O. The Options dialog box displays (see figure 6-10). Figure 6-10.
6 – Getting Started Setting Up Automatic Alarm Notification by Email Q 6.11 Setting Up Automatic Alarm Notification by Email You can automatically send alarm notifications with a copy of the current host configuration by email to a distribution list, thus enabling the information to be opened and analyzed from other locations. Alarm notification is available only with SMTP email servers. NOTE: For information about viewing alarm notifications received by email, see section 8.2.5.
Q 6 – Getting Started Specifying the HBA Driver Settings 4. In the Notification Options section, do the following: a. Select the check boxes for the alarm notifications that you want to send. For detailed information about alarms, see section 8.2.1. ❑ ❑ ❑ ❑ Information Alarms check box Unknown Alarms check box Warning Alarms check box Bad Alarms check box b. If you want to send the current host configuration, select the Attach Host Configuration check box. 5.
6 – Getting Started Specifying the HBA Driver Settings Q Perform the following steps to set the HBA driver parameters: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA. 2. Select the Settings tab. The HBA Driver Settings tabbed page displays (see figure 6-12). Figure 6-12. HBA Driver Settings Tabbed Page The identifying information displays: ❑ ❑ Hostname. The name or IP address of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA 3.
Q 6 – Getting Started Refreshing the Configuration 4. In the Group: Binding section, select one of the following to specify whether the driver binds the target ID using the target’s world wide port name (WWPN) or port ID: ❑ If you want the driver to bind the target ID using the target’s WWPN, select the Bind by World Wide Port Name radio button. ❑ If you want the driver to bind the target using the target’s port ID, select the Bind by Port ID radio button. LUN masking is disabled.
6 – Getting Started Refreshing the Configuration Q Notes 6-20 FS0054603-00 C
Section 7 Setting Up Connections You can connect to and configure local and remote systems. This section discusses: ■ Connecting to one or multiple hosts (see section 7.1) ■ Configuring Fibre Channel devices using wizards. Wizards simplify the configuration process. ■ ■ ❑ Configuring HBA ports and binding target devices using the General Configuration Wizard (see section 7.2) ❑ Configuring LUN masking using the LUN Masking Wizard (see section 7.
7 – Setting Up Connections Connecting to Hosts Q 7.1 Connecting to Hosts The SANsurfer FC HBA Manager GUI tries to ensure that a host is not loaded more than once into the HBA tree. If a host has multiple interfaces (for example, more than one NIC is installed), the SANsurfer FC HBA Manager GUI will not load the host more than once in the HBA tree if the host IP address is registered with the DNS server or local host file.
Q 7 – Setting Up Connections Connecting to Hosts The Connect to Host dialog box displays (see figure 7-1). Figure 7-1. Connect to Host Dialog Box 2. In the Enter Hostname or IP Address box, do one of the following: ❑ Select localhost to connect to the machine on which you are using the SANsurfer FC HBA Manager GUI. ❑ Type or select a remote machine. You can use the host name or the machine’s IP address. 3. Do one of the following: ❑ Click Connect to initiate the connection.
Q 7 – Setting Up Connections Connecting to Hosts The hosts display in the HBA tree and in the Connect to Host dialog box Enter Hostname or IP Address box drop-down list. If, for example, the SANsurfer FC HBA Manager agent on the host stops running, the host no longer displays in the HBA tree. NOTE: You must manually connect to a host on a different subnet (see section 7.1.1). Perform the following steps to auto connect to all hosts: 1.
Q 7 – Setting Up Connections Connecting to Hosts 7.1.3 Connecting to Hosts Using a Host Group File You can connect to a group of hosts using a host group file that you previously created. This section discusses: ■ ■ Creating a host group file (see section 7.1.3.1) Using a host group file to connect to hosts (see section 7.1.3.2) 7.1.3.1 Creating a Host Group File Perform the following steps to save the group of hosts that display in the HBA tree to a host group file: 1.
7 – Setting Up Connections Connecting to Hosts Q 7.1.3.2 Using a Host Group File to Connect to Hosts Perform the following steps to connect to a group of hosts using a previously created host group file: 1. Do one of the following: ❑ On the SANsurfer FC HBA Manager main window Host menu, click Open Group. ❑ Right-click the HBA tree. From the pop-up menu, click Open Group. ❑ Press SHIFT+O. 2. The Open dialog box displays. Select the host group file (.
Q 7 – Setting Up Connections Connecting to Hosts 7.1.4.1 Connecting on Windows 2000/Windows Server 2003 On a Windows 2000/Windows Server 2003 system, perform the following steps to connect to one or more specified hosts automatically when starting the SANsurfer FC HBA Manager GUI from the command line. When done, the SANsurfer FC HBA Manager main window displays with the specified hosts. 1.
Q 7 – Setting Up Connections Connecting to Hosts 4. Do one of the following: ❑ Type the following and then press ENTER to connect to the local host: ./SANsurfer -l (the letter L for local) ❑ Type the following and then press ENTER to connect to a single host at start up. hostname is the host name or IP address: ./SANsurfer -h hostname For example: ./SANsurfer -h adsw2ksys2 ❑ Type the following and then press ENTER to connect to the hosts listed in a group file (.hst) at start up.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard 7.2 Configuring HBA Ports Using the General Configuration Wizard Perform the following steps to configure HBA ports (connection option and data rate) and bind target devices attached to the HBA port using the General Configuration Wizard.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard The HBA Port Selection dialog box displays (see figure 7-3). Figure 7-3. HBA Port Selection Dialog Box NOTE: If you want to sort the existing entries in the table, click the column heading. A triangle displays in the heading, indicating an ascending sort (default). Click the triangle for a descending sort. The dialog box provides: ❑ Information about the HBA port configuration process.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard Do the following: a. From the table, select the HBA port that you want to configure. You can select only one HBA port. NOTE: When you finish, you will be prompted whether you want to configure another HBA port. b. Do one of the following: ❑ Click Next to proceed. ❑ Click Cancel to exit the General Configuration Wizard without making any changes. ❑ Click Help to display context-sensitive help. 2.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard The dialog box displays the following information: ❑ HBA. HBA port number and HBA model ❑ Node Name. World wide HBA node name ❑ Port Name. World wide HBA port name ❑ Driver Version. Version of the HBA driver on the host that controls the HBA ❑ BIOS Version. BIOS version on the HBA (Windows 2000/Windows Server 2003, Linux, NetWare, and Solaris) ❑ FCode Version.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard 3. If you clicked Next, the HBA Port Connection Settings dialog box displays (see figure 7-5). Figure 7-5. HBA Port Connection Settings Dialog Box The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ FS0054603-00 C Hostname. The name or IP address of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name. World wide HBA port name Port ID.
7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard Q Configure the following connection option and data rate FC connection parameters. a. In the Connection Options box, select the type of connection (loop or point-to-point) or connection preference. See section 11.1.1 for details. NOTE: Configuring the connection option is available only on QLA2xxx HBAs. This option is not available on QLA200 HBAs, and appears dimmed on the HBA Port Connection Settings dialog box. b.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard 4. If you clicked Next, the Target Persistent Binding dialog box displays (see figure 7-6). With target persistent binding, you can bind devices seen by the operating system. NOTE: This feature is not supported in Novell NetWare. Figure 7-6. Target Persistent Binding Dialog Box NOTE: If you want to sort the existing entries in the table, click the column heading.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard The target persistent binding information displays: ❑ ❑ ❑ ❑ ❑ ❑ Bind. Whether target persistent binding is selected Type. Type of device Device Info. Device vendor and device product ID Port Name. World wide device port name Port ID. Port ID of the device Target ID. Target ID of the device Perform the following steps to bind devices attached to HBA ports. a.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard c. Do one of the following: ❑ Click Back to return to the previous dialog box. ❑ Click Next to proceed. ❑ Click Cancel to exit the General Configuration Wizard without making any changes. ❑ Click Help to display context-sensitive help. 5. If you clicked Next, the Confirm Changes dialog box displays (see figure 7-7). Figure 7-7.
7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard Q The HBA’s settings based on the changes display: ❑ HBA Port Information ❑ ❑ ❑ ❑ ❑ HBA. HBA port number and HBA model Node Name. World wide HBA node name Port Name. World wide HBA port name Configuration Options Settings ❑ Connection Options. Type of connection (loop or point-to-point) or connection preference ❑ Data Rate.
Q 7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard 7. The HBA Port Configuration Status dialog box displays (see figure 7-8). Figure 7-8. HBA Port Configuration Status Dialog Box The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. The name or IP address of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name. World wide HBA port name Port ID.
7 – Setting Up Connections Configuring HBA Ports Using the General Configuration Wizard Q 8. If you clicked Next, the HBA port configuration status message asks whether you want to configure another HBA port. Click OK to configure another HBA port; the HBA Port Selection dialog box displays (see step 1). Click Cancel to proceed to the Finish dialog box. 9. If you clicked Cancel, the Finish dialog box displays (see figure 7-9). Figure 7-9.
Q 7 – Setting Up Connections Configuring LUN Masking Using the LUN Masking Wizard 7.3 Configuring LUN Masking Using the LUN Masking Wizard Use the LUN Masking Wizard to set individual LUNs as masked or unmasked from the operating system. Enabling a LUN sets the LUN as unmasked; disabling a LUN sets the LUN as masked. NOTE: You can also set individual LUNs as masked or unmasked by using the LUN Configuration dialog box (see section 7.5.1.2). 1. Start the LUN Masking Wizard.
7 – Setting Up Connections Configuring LUN Masking Using the LUN Masking Wizard Q The dialog box provides: ❑ Information about the LUN masking process. ❑ Device information: ❑ ❑ ❑ ❑ Select. Whether the device is selected for LUN masking configuration Device Info. Device vendor and device product ID Node Name. World wide HBA node name Configured. Whether the device is configured Do the following: a. From the table, select the Select check box for device that you want to configure.
Q 7 – Setting Up Connections Configuring LUN Masking Using the LUN Masking Wizard NOTE: If you want to sort the existing entries in the table, click the column heading. A triangle displays in the heading, indicating an ascending sort (default). Click the triangle for a descending sort. The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Device Product Vendor. Device manufacturer Device Product ID. Product ID of the device Device Product Rev. Device revision level Device Node Name.
7 – Setting Up Connections Configuring LUN Masking Using the LUN Masking Wizard Q 3. If you clicked Next, the Confirm Changes dialog box displays (see figure 7-12). Figure 7-12. Confirm Changes Dialog Box The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Device Product Vendor. Device manufacturer Device Product ID. Product ID of the device Device Product Rev. Device revision level Device Node Name. World wide node name of the device Device Port Name.
Q 7 – Setting Up Connections Configuring LUN Masking Using the LUN Masking Wizard Do the following: a. Review the settings. b. To save the configuration for reference, click Save Configuration to File. c. Do one of the following: ❑ Click Back to return to the previous dialog box. ❑ Click Next to proceed. ❑ Click Cancel to exit the LUN Masking Wizard without making any changes. ❑ Click Help to display context-sensitive help. 4. If you clicked Next, the Security Check dialog box displays.
7 – Setting Up Connections Configuring LUN Masking Using the LUN Masking Wizard Q Do the following: a. Read the information about the changes and the process. b. Do one of the following: ❑ Click Back to return to the previous dialog box. ❑ Click Next to proceed. ❑ Click Cancel to exit the LUN Masking Wizard without making any changes. ❑ Click Help to display context-sensitive help. 6. If you clicked Next, the device configuration status message asks whether you want to configure another device.
Q 7 – Setting Up Connections Configuring Fibre Channel Devices 7.4 Configuring Fibre Channel Devices Perform the following steps to configure Fibre Channel devices: 1. From the SANsurfer FC HBA Manager main window, do the following: a. In the HBA tree, select the host (or HBA, HBA port, device, or LUN connected to the host). b. Do one of the following: ❑ Click the Configure button on the toolbar. ❑ From the Host menu, click Configure.
Q 7 – Setting Up Connections Configuring Fibre Channel Devices The host name displays in the title bar. The table is a two-dimensional view of the HBAs ports and devices in the machine. The following information displays: ❑ Node Name. World wide device node name ❑ Port Name. World wide device port name ❑ Port ID. Device port ID ❑ HBA Port n (State/Topo/Bind/ID). The HBA port cell in the table represents a path from the HBA port to the device.
Q 7 – Setting Up Connections Configuring Fibre Channel Devices ❑ Bind target devices attached to the HBA port (see section 7.7) ❑ Delete persistent configuration data for an HBA port or device (see section 7.9). ❑ View information (see section 7.6): ❑ ❑ ❑ HBA port information (see section 7.6.1) Device information (see section 7.6.2) Get help. From the Help menu, click Browse Contents. The help text for the Fibre Channel Port Configuration dialog box displays. 3.
7 – Setting Up Connections Configuring Fibre Channel Devices Q 7.4.1 Configuring Device Paths for this Host You can configure device paths for a host as visible, hidden, or unconfigured. Use the following options as appropriate: ■ Configuring, unconfiguring, and inversing the configuration of all device paths (see section 7.4.1.1) ■ Configuring individual device paths (see section 7.4.1.2) NOTE: There must be one visible path for the operating system to see a device. 7.4.1.
Q 7 – Setting Up Connections Configuring Fibre Channel Devices 7.4.1.2 Configuring Individual Device Paths Perform the following steps to set device path visibility to the operating system. NOTE: There must be one visible path for the operating system to see the device. 1. From the Fibre Channel Port Configuration dialog box, right-click in the cell in the HBA Port n column. 2.
Q 7 – Setting Up Connections Configuring LUNs for a Device 7.4.2.1 Enabling and Disabling All LUNs on this Host You can configure LUN masking—setting LUNs masked or unmasked from the operating system. Enabling a LUN sets the LUN as unmasked; disabling a LUN sets the LUN as masked. Perform the following steps to enable or disable all LUNs on this host: 1. From the Fibre Channel Port Configuration dialog box LUNs menu, select Enable LUNs. 2.
Q 7 – Setting Up Connections Configuring LUNs for a Device The LUN Configuration dialog box displays for the device (see figure 7-16). Figure 7-16. LUN Configuration Dialog Box The title bar displays the host name and world wide device node name. The table displays the following information: ❑ ❑ ❑ LUN. LUN number Enable. Whether the LUN is enabled Port Name. World wide device port name 2.
7 – Setting Up Connections Configuring LUNs for a Device Q 3. Do one of the following: ❑ Click OK to save the changes until you exit the Fibre Channel Port Configuration dialog box, where you determine what happens to all the configuration changes (see section 7.2, step 3). If SANsurfer FC HBA Manager detects an invalid LUN configuration during an attempt to save the configuration, the invalid configuration—automatically configure invalid LUNs message displays.
Q 7 – Setting Up Connections Viewing HBA Port and Device Information 7.5.1.2 Enabling and Disabling LUN Masking on Individual LUNs NOTE: You can also use the LUN Masking Wizard to enable and disable LUN masking on individual LUNs (see section 7.3). You can configure LUN masking for a specific LUN as enabled or disabled. In the LUN Configuration dialog box Enable column, do one of the following: ■ ■ Select the Enable check box to enable LUN masking. Clear the Enable check box to disable LUN masking.
7 – Setting Up Connections Viewing HBA Port and Device Information Q The following information displays: ❑ Port. HBA port number ❑ OS Instance. The operating system number from which the HBA can be accessed (Solaris SPARC). ❑ Type. HBA model ❑ HBA Alias. Symbolic name given to the HBA on the HBA Information tabbed page. ❑ Port Alias. Symbolic name given to the HBA port on the HBA Port Information tabbed page. ❑ Serial Number. Serial number of the HBA ❑ Driver Version.
Q 7 – Setting Up Connections Viewing HBA Port and Device Information 7.6.2 Viewing Device Information Perform the following steps to view device (disk and tape) information from the Fibre Channel Port Configuration dialog box and LUN Configuration dialog box: 1. To display information about a device, do one of the following: ❑ From the Fibre Channel Port Configuration dialog box, right-click a cell in the device Node Name, device Port Name, or device Port ID column.
Q 7 – Setting Up Connections Binding Target Devices Attached to the HBA Port Using the Fibre Channel Port 7.7 Binding Target Devices Attached to the HBA Port Using the Fibre Channel Port Configuration Dialog Box NOTE: ■ This feature is not supported in Novell NetWare. ■ You can also use the General Configuration Wizard (Target Persistent Binding dialog box) (see section 7.2) or the Target Persistent Binding tabbed page (see section 7.8) to bind devices attached to HBA ports.
Q 7 – Setting Up Connections Binding Target Devices Attached to the HBA Port Using the Fibre Channel Port The Fibre Channel Port Configuration dialog box is shown in figure 7-19. Figure 7-19. Fibre Channel Port Configuration Dialog Box 2. Select the Bind check box if you want to configure the port and bind it to the target ID that you have selected in the ID drop-down box. If you do not want to configure the port, clear the check box.
7 – Setting Up Connections Binding Target Devices Using the Target Persistent Binding Tabbed Page Q In Windows 2000/Windows Server 2003, target IDs can be assigned only to ports that will be configured. Valid targets ID values are in the range 0–(n–1), where n is the number of targets attached to the HBA. In Solaris SPARC, the target ID cannot be modified if the device has been selected as a boot device.
Q 7 – Setting Up Connections Binding Target Devices Using the Target Persistent Binding Tabbed Page Perform the following steps to bind target devices attached to an HBA port: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA port. 2. Select the Target Persistent Binding tab. The Target Persistent Binding tabbed page displays (see figure 7-20). Figure 7-20. Target Persistent Binding Tabbed Page NOTE: If you want to sort the existing entries in the table, click the column heading.
7 – Setting Up Connections Binding Target Devices Using the Target Persistent Binding Tabbed Page Q The target persistent binding information displays: ❑ ❑ ❑ ❑ ❑ ❑ Bind. Whether target persistent binding is selected Type. Type of device Device Info. Device vendor and device product ID Port Name. World wide device port name Port ID. Port ID of the device Target ID. Target ID of the device 3.
Q 7 – Setting Up Connections Deleting Persistent Configuration Data 7.9 Deleting Persistent Configuration Data When you select persistent configuration data, the current configuration data displays if one exists. You can do the following: ■ Delete the persistent configuration data for an HBA port and its devices and LUNs (see section 7.9.1). ■ Delete the persistent configuration data for a device and its LUNs (see section 7.9.2). 7.9.
Q 7 – Setting Up Connections Deleting Persistent Configuration Data 2. Do one of the following: Delete one or more entries as follows: ❑ a. Select the HBA port entries that you want to delete. b. Click Delete to remove the entries. c. The Security Check dialog box displays. In the Enter Password box, type the password. Click OK. NOTE: ❑ Changes made to the persistent configuration are final. If you do not want the changes, reconfigure the host (see section 7.2). Click Cancel to not delete an entry.
Q 7 – Setting Up Connections Viewing a Saved Host Configuration from a File (.qlc) 2. Do one of the following: ❑ Delete one or more entries as follows: a. Select the device entries that you want to delete. b. Click Delete to remove the entries. c. The Security Check dialog box displays. In the Enter Password box, type the password. Click OK. NOTE: ❑ Changes made to the persistent configuration are final. If you do not want the changes, reconfigure the host (see section 7.2).
7 – Setting Up Connections Viewing a Saved Host Configuration from a File (.qlc) Q 2. When successful, the host configuration successfully saved to file message displays. The message includes the path and file name (in the format hostname_date_number.qlc). NOTE: Write down the path and file name of the host configuration file. 7.10.2 Viewing the Host Configuration from a File Perform the following steps to view the saved virtual host configuration from a .qlc file.
Q 7 – Setting Up Connections Viewing a Saved Host Configuration from a File (.qlc) 3. The load host configuration message displays. Click OK. The virtual host configuration displays in the HBA tree. Note that the host configuration is displayed as offline and the icons are blue. You can still view configuration information (see figure 7-23). Figure 7-23. Virtual Host Configuration from a File 4. To remove a virtual host configuration from the HBA tree, disconnect it (see section 7.1.5).
Q 7 – Setting Up Connections Viewing a Saved Host Configuration from a Text File (.txt) 7.11 Viewing a Saved Host Configuration from a Text File (.txt) You can view a text file (.txt) of the host configuration that you saved to an external file in your working directory. This section discusses: ■ ■ Saving the host configuration to a text file (see section 7.11.1) Viewing the host configuration from a text file (see section 7.11.2) 7.11.
Q 7 – Setting Up Connections Viewing a Saved Host Configuration from a Text File (.txt) 7.11.2 Viewing the Host Configuration from a Text File Perform the following steps to view the host configuration from a text file: 1. Do one of the following: ❑ From a Windows 2000/Windows Server 2003 system, open the Notepad window. ❑ From a Red Hat/SuSE Linux or Solaris SPARC system, open a terminal and use the vi editor. 2. Open the text file to view the host configuration.
7 – Setting Up Connections Printing a Host Configuration Q 7.12 Printing a Host Configuration Perform the following steps to print a host configuration: 1. From the SANsurfer FC HBA Manager main window, do the following: a. In the HBA tree, select the host (or HBA, HBA port, device, or LUN connected to the host). b. Do one of the following: ❑ Click the Configure button on the toolbar. ❑ From the Host menu, click Configure. ❑ Right-click the host, HBA, HBA port, device, or LUN in the HBA tree.
Q 7 – Setting Up Connections Comparing Host Configurations Perform the following steps to compare the current host configuration (online) to a previously saved host configuration file (offline) (see section 7.11.1). 1. From the SANsurfer FC HBA Manager main window, do one of the following: ❑ ❑ From the Host menu, select Compare Host. Press CTRL+SHIFT+C. 2. The Open dialog box displays. Select a .qlc file from the local working directory. Click Open.
7 – Setting Up Connections Comparing Host Configurations Q Use the buttons on the toolbar to navigate through the Offline Host and Online Host tabbed pages: ■ Click the binoculars button to search the host configuration for a requested name. If the search is found, the two tabbed pages are synchronized and the found text is displayed with the selection color of the operating system (the selection color supersedes the change colors).
Section 8 Monitoring the Connections SANsurfer FC HBA Manager continuously monitors connected hosts and informs you of various conditions and problems through the alarm log and event log. This section discusses: ■ ■ Viewing and managing the event log (see section 8.1) Viewing and managing the alarm log (see section 8.2) 8.1 Viewing and Managing the Event Log The event log displays events relating to SANsurfer FC HBA Manager operations for any host connected to your system.
8 – Monitoring the Connections Viewing and Managing the Event Log Q The Event Log dialog box displays (see figure 8-1). Figure 8-1. Event Log Dialog Box NOTE: If you want to sort the existing entries in the Event Log dialog box, click the column heading. A triangle displays in the heading, indicating an ascending sort (default). Click the triangle for a descending sort. The Event Log dialog box includes the following information about each event: ❑ Type. The severity of the event.
Q 8 – Monitoring the Connections Viewing and Managing the Event Log 2. To view an individual event, double-click the event. The Event Details dialog box displays (see figure 8-2). Figure 8-2. Event Details Dialog Box The Event Details dialog box displays the time stamp and message. Do the following as appropriate: ❑ ❑ ❑ Click Next to view the details of the next event. Click Previous to view the details of the previous event. Click Close to return to the Event Log dialog box. 3.
8 – Monitoring the Connections Viewing and Managing the Event Log Q 8.1.3 Exporting the Event Log Perform the following steps to export the current events to a comma separated values (CSV) file, which can be exported to another application: 1. From the Event Log dialog box, click Export. See section 8.1.1 for information on accessing the Event Log dialog box. 2. You are prompted to select a location and a file name (see figure 8-3).
Q 8 – Monitoring the Connections Viewing and Managing the Event Log Figure 8-4 shows an example output file, which contains the following event information: ■ ■ ■ Event status (unknown, bad, good, or warning) Time stamp Message Figure 8-4. Export Event Log—Sample Output File 8.1.4 Printing the Event Log Perform the following steps to print the event log. NOTE: See section 8.1.1 for information on accessing the Event Log dialog box. 1. From the Event Log dialog box, click Print. 2.
Q 8 – Monitoring the Connections Viewing and Managing the Alarm Log 8.2 Viewing and Managing the Alarm Log SANsurfer FC HBA Manager continuously monitors the connected hosts for alarms. Both the HBA icon and HBA port icon on the HBA tree display alarm status. When SANsurfer FC HBA Manager receives an alarm, the HBA icon and HBA port icon display the most severe alarm received. For a listing of all alarm status types, see section 8.2.1.
Q 8 – Monitoring the Connections Viewing and Managing the Alarm Log This section discusses: ■ ■ ■ ■ ■ Viewing the alarm log (see section 8.2.1) Clearing the alarm log (see section 8.2.2) Exporting the alarm log (see section 8.2.3) Printing the alarm log (see section 8.2.4) Viewing an alarm log received by email (see section 8.2.5) NOTE: See section 6.10 for information about setting the alarm log options. 8.2.
8 – Monitoring the Connections Viewing and Managing the Alarm Log Q The Alarm Log dialog box displays (see figure 8-6). Figure 8-6. Alarm Log Dialog Box NOTE: If you want to sort the existing entries in the Alarm Log dialog box, click the column heading. A triangle displays in the heading, indicating an ascending sort (default). Click the triangle for a descending sort. The Alarm Log dialog box includes the following information about each alarm: ❑ Time Stamp.
Q 8 – Monitoring the Connections Viewing and Managing the Alarm Log 2. To view an individual alarm, double-click the alarm. The Alarm Details dialog box displays (see figure 8-7). Figure 8-7. Alarm Details Dialog Box The Alarm Details dialog box displays the time stamp, host name, HBA ID (HBA port number and HBA model), and description. Do the following as appropriate: ❑ ❑ ❑ Click Next to view the details of the next alarm. Click Previous to view the details of the previous alarm.
8 – Monitoring the Connections Viewing and Managing the Alarm Log Q 8.2.2 Clearing the Alarm Log Perform the following steps to purge the Alarm Log dialog box of all its entries: 1. From the Alarm Log dialog box, click Clear. See section 8.2.1 for information on accessing the Alarm Log dialog box. 2. The clear alarm entries confirmation message displays. Do one of the following: ❑ ❑ Click OK to clear the alarms.
Q 8 – Monitoring the Connections Viewing and Managing the Alarm Log 8.2.3 Exporting the Alarm Log Perform the following steps to export the current alarms to a CSV file, which can be exported to another application: 1. From the Alarm Log dialog box, click Export. See section 8.2.1 for information on accessing the Alarm Log dialog box. 2. You are prompted to select a location and a file name (see figure 8-8).
8 – Monitoring the Connections Viewing and Managing the Alarm Log Q Figure 8-9 shows an example output file, which contains the time stamp, host name, HBA ID (HBA port number and HBA model), and description. Figure 8-9. Export Alarm Log—Sample Output File 8.2.4 Printing the Alarm Log Perform the following steps to print the alarm log: NOTE: See section 8.2.1 for information on accessing the Alarm Log dialog box. 1. From the Alarm Log dialog box, click Print. 2. Print the alarm log.
Q 8 – Monitoring the Connections Viewing and Managing the Alarm Log 8.2.5 Viewing an Alarm Notification Received by Email You can automatically send alarm notifications with a copy of the host configuration by email to a distribution list, thus enabling the information to be opened and analyzed from other locations. For details about setting up automatic alarm notification by email, see section 6.11.
Q 8 – Monitoring the Connections Viewing and Managing the Alarm Log 2. If the email notification was sent with the host configuration, there will be an attached .qlc file. Do the following: a. Download the .qlc file. b. Open the .qlc file. This is a virtual host configuration file, and the procedures are the same as viewing a saved virtual host configuration from a file (see section 7.11.2). Note the following: ❑ ❑ If not already started, start the SANsurfer FC HBA Manager.
Section 9 Displaying Host, HBA, HBA Port, Device, and LUN Information You can display information about hosts, HBAs, HBA ports, devices, and LUNs. This section discusses viewing information about the following: ■ Hosts —general host information and topology (see section 9.1) ■ HBAs—general HBA information (see section 9.2) ■ HBA ports —general HBA port information, device list, statistics, and link status (see section 9.3) ■ Devices—general device information and LUN list (see section 9.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying Host Information 9.1.1 Viewing General Host Information Perform the following steps to view general information about a host: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the host. 2. Select the Information tab. The Host Information tabbed page displays (see figure 9-1). Figure 9-1. Host Information Tabbed Page The following information displays: ❑ ❑ ❑ ❑ 9-2 Hostname.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying Host Information 9.1.2 Viewing Topology Information Perform the following steps to view the topology for a host: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the host. 2. Select the Topology tab. The Topology tabbed page displays (see figure 9-2). Figure 9-2. Topology Tabbed Page The following information displays: ❑ Hostname.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Information 9.2 Displaying HBA Information Perform the following steps to view general information about an HBA connected to a host: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA. 2. Select the Information tab. The HBA Information tabbed page displays (see figure 9-3). Figure 9-3. HBA Information Tabbed Page The identifying information displays: ❑ ❑ Hostname.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information ❑ Driver Version. Version of the HBA driver on the host that controls the HBA ❑ Firmware Version. Version of the HBA firmware on the host that controls the HBA 9.3 Displaying HBA Port Information You can view the following HBA port information: ■ ■ ■ ■ General HBA port information (see section 9.3.1) Device list (see section 9.3.2) HBA port statistics (see section 9.3.3) Link status (see section 9.3.
9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information Q The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. The name or IP address of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name. World wide HBA port name Port ID. Port ID of the HBA port The general information displays: 9-6 ❑ Port Alias. Symbolic name you can assign to the HBA port for identification purposes.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information 9.3.2 Viewing the Device List Perform the following steps to display information about devices (disks and tapes) attached to an HBA port: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA port. 2. Select the Device List tab. The Device List tabbed page displays (see figure 9-5). Figure 9-5.
9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information Q The device list information displays: ❑ ❑ ❑ ❑ ❑ ❑ ❑ Path. Path number Target. Device ID of the device Device ID. Complement of the AL_PA Port ID. Port ID of the device Product Vendor. Product vendor of the device Product ID. Product ID of the device Product Revision. Product revision level of the device 9.3.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. The name or IP address of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name. World wide HBA port name Port ID. Port ID of the HBA port The statistical information displays: ❑ HBA Port Errors.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information 9.3.3.2.2 Updating HBA Port Statistics Automatically Perform the following steps to set the system to update HBA port statistics automatically: 1. Select the Auto Poll check box. 2. Click Set Rate. The Statistics Sampling Rate dialog box displays (see figure 9-7). Figure 9-7. Statistics Sampling Rate Dialog Box 3. In the Sampling Rate box, type the sampling rate interval. The range is 5 to 30 seconds.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information 9.3.3.3 Exporting HBA Port Statistics Perform the following steps to export the HBA port statistics to a comma separated values (CSV) file, which can be exported to another application. 1. From the HBA Port Statistics tabbed page (see figure 9-6), select the Log to File check box. See section 9.3.3.1 for information on accessing the Host Port Statistics tabbed page. 2.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information Figure 9-9 shows an example output file, which contains the following HBA port statistics information: ■ ■ ■ ■ ■ ■ HBA port errors Device errors Resets I/O count IOPS Bytes per second (bps) Figure 9-9.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying HBA Port Information 9.3.4 Viewing Link Status Perform the following steps to view the link information for devices attached to an HBA port: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA port. 2. Select the Link Status tab. The Link Status tabbed page displays (see figure 9-10). Figure 9-10.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying Device Information The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. The name or IP address of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name. World wide HBA port name Port ID. Port ID of the HBA port The link status information displays: ❑ Port Name. For the HBA port, the world wide HBA port name displays.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying Device Information 9.4.1 Viewing General Device Information Perform the following steps to view general information about a device (disk or tape): 1. In the SANsurfer FC HBA Manager main window HBA tree, select the device. 2. Select the Information tab. The Device Information tabbed page displays (see figure 9-11). Figure 9-11. Device Information Tabbed Page The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname.
9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying Device Information Q 9.4.2 Viewing the LUN List Perform the following steps to display information about LUNs: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the device. 2. Select the LUN List tab. The LUN List tabbed page displays (see figure 9-12). Figure 9-12. LUN List Tabbed Page NOTE: If you want to sort the existing entries in the table, click the column heading.
Q 9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying LUN Information The LUN list information displays: ❑ ❑ ❑ ❑ ❑ ❑ ❑ LUN. LUN number Vendor. Manufacturer of the LUN Product ID. Product ID of the LUN Product Rev. Product revision level of the LUN World Wide Unique LUN Name. World wide name of the LUN Size. Capacity of the LUN in megabytes or gigabytes Disk Number. Disk number of the LUN 9.
9 – Displaying Host, HBA, HBA Port, Device, and LUN Information Displaying LUN Information Q The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Device Product Vendor. Device manufacturer Device Product ID. Product ID of the device Device Product Rev. Device revision level Device Node Name. World wide node name of the device Device Port Name. World wide port name of the selected device’s port Device Port ID.
Section 10 Performing Diagnostics Diagnostic tests interrupt normal HBA operations. The HBA’s state before the tests are restored at the completion of the testing. Note the following: ■ Run these tests when no other activities are required of the HBA. ■ Tests read and write to sensitive areas on the HBA. ■ Disruption of some diagnostic tests may require a complete update of the HBA’s critical memory areas.
10 – Performing Diagnostics Preparing for Diagnostic Testing Q Perform the following steps to run a read/write buffer test: 1. 2. 3. 4. Prepare for the test (see section 10.1). Set the diagnostic test parameters (see section 10.2). Run the diagnostic test (see section 10.3). View the diagnostic test results (see section 10.4).
Q 10 – Performing Diagnostics Preparing for Diagnostic Testing 10.1.2 Preparing for the Loopback Test Perform the following steps before running the loopback test: 1. Modify the HBA port settings Connection Options setting (see section 10.1.2.1). 2. Attach a loopback connector to the Fibre Channel connector on the HBA port (see section 10.1.2.2).
10 – Performing Diagnostics Preparing for Diagnostic Testing Q 10.1.2.1 Modifying the HBA Settings Connection Options Setting Before running the loopback test, the HBA port settings Connection Options setting must be set appropriately. See section 11.1.1 for information about viewing and modifying the setting. Do the following: 1. Write down the current setting. 2.
Q 10 – Performing Diagnostics Preparing for Diagnostic Testing 10.1.3 Preparing for the Read/Write Buffer Test The read/write buffer test must be run on a device (disk or tape). Before running the read/write buffer test, from the SANsurfer FC HBA Manager main window HBA tree, verify that the HBA port is connected to at least one device. NOTE: Some devices may not support Read/Write Buffer commands. Check with your hardware vendor or manufacturer.
10 – Performing Diagnostics Setting the Diagnostic Test Parameters Q 10.2 Setting the Diagnostic Test Parameters Perform the following steps to set the loopback or read/write buffer test parameters: 1. From the SANsurfer FC HBA Manager main window HBA tree, select the HBA port. 2. Click the Diagnostics tab. The Diagnostics tabbed page displays (see figure 10-1). Figure 10-1. Diagnostics Tabbed Page The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname.
Q 10 – Performing Diagnostics Setting the Diagnostic Test Parameters 3. The data pattern sets the test pattern. In the Data Pattern drop-down box, do one of the following: ❑ Select a data byte. ❑ Select Customized to specify your own eight-byte pattern; then enter the data in hexadecimal format (0–FF) into the eight Customized boxes. ❑ Select Random to randomly generate an eight-byte data pattern. 4. The data size sets the number of bytes transferred when the test is run.
Q 10 – Performing Diagnostics Running Diagnostic Tests 10.3 Running Diagnostic Tests Once you have set the test parameters as described in section 10.2, perform the following steps to run the loopback or read/write buffer test: 1. Click the Loopback Test or Read/Write Buffer Test button. 2. The diagnostic tests warning displays. Do one of the following: ❑ ❑ Click Yes if there are no I/Os active and you want to proceed with the test. Click No to cancel the diagnostic test. 3.
Q 10 – Performing Diagnostics Viewing the Diagnostic Test Results 10.4 Viewing the Diagnostic Test Results The test results section of the Diagnostics tabbed page displays the results of a test run (see figure 10-2). The Test Status column indicates whether the test passed or failed. The remaining information pertains to error counters. Figure 10-2. Diagnostic Test Results Section NOTE: If you want to sort the existing entries in the table, click the column heading.
Q 10 – Performing Diagnostics Viewing the Diagnostic Test Results 10.4.1 Loopback Test Results The Loopback Test Results section provides the following information: ■ Tests Status. Whether the test passed or failed. The possible values: ❑ ❑ ❑ ❑ Success. The test passed. Error. CRC, disparity, or frame length errors occurred. Failed. An error occurred when attempting to issue a command. Loop down. The loop is down. ■ CRC Error. Number of CRC errors ■ Disparity Error.
Q 10 – Performing Diagnostics Viewing the Diagnostic Test Results 10.4.2 Read/Write Buffer Test Results The Read/Write Buffer Test Results section provides the following information, as shown in figure 10-4. Figure 10-4. Diagnostic Test Results—Read/Write Buffer Test ■ ■ Loop ID/Status ❑ The loop ID of the HBA when operating in loop mode. ❑ The status of the test—whether the test passed or failed. The possible values: Success. The test passed. ❑ Error.
Q 10 – Performing Diagnostics Preparing for Normal HBA Operations ❑ ❑ R/W buffer not supported Write buffer failed ■ Link Failure. Number of link failures ■ Sync Loss. Number of sync loss errors ■ Signal Loss. Number of signal loss errors ■ Invalid CRC. Number of invalid CRCs If the value in the Data Miscompare column is nonzero, you can view the miscompare information by double-clicking any column. The Diagnostic Details dialog box displays (see figure 10-5). Figure 10-5.
Section 11 Updating the HBA You can update an HBA’s nonvolatile RAM (NVRAM) settings, OptionROM (BIOS or FCode), and driver. You can also save the NVRAM, BIOS, or FCode settings to a file. This section discusses: ■ ■ ■ ■ ■ ■ Updating HBA settings (see section 11.1) Restoring default NVRAM settings from a file (see section 11.2) Updating the flash BIOS from a file (see section 11.3) Updating the FCode (see section 11.4) Saving NVRAM, flash BIOS, and FCode (see section 11.
Q 11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device The Settings tabbed page displays parameters that are saved in NVRAM. These settings configure Fibre Channel devices and the QLA200/QLA2xxx HBA to which they are attached (see figure 11-1). Figure 11-1. Settings Tabbed Page (HBA Port Settings) Sample The identifying information displays: ■ ■ ■ ■ ■ ■ Hostname. Name of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port.
Q 11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device Perform the following steps to modify the settings for the selected HBA ports: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA port. If you want to configure multiple HBA ports with the same settings, hold the CTRL key while selecting multiple HBA ports. The HBA ports must be in the same series (QLA23xx HBAs, QLA22xx HBAs, or QLA200 HBAs).
Q 11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device 5. When finished modifying the HBA settings, do one of the following: ❑ Click Save to save the updated settings to the HBA. The Security Check dialog box displays. In the Enter Password box, type the password. Click OK. The save message displays when the changes have been saved to the HBA. NOTE: 11-4 ■ You must reboot the HBA for the changes to take effect.
Q 11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device 11.1.1 HBA Port Settings To view or modify the HBA port NVRAM settings, on the Settings tabbed page Select Settings section box, select HBA Port Settings. The HBA Port Settings section displays the current settings. For QLA23xx HBAs and QLA22xx HBAs, see figure 11-3. Parameters that are not supported for the HBA do not display; parameters that cannot be modified appear dimmed. Figure 11-3.
11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device Q For QLA200 HBAs, see figure 11-4. Parameters that are not supported for the HBA do not display; parameters that cannot be modified appear dimmed. Figure 11-4.
Q 11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device The default settings for the QLA200/QLA2xxx HBAs are listed in table 11-1 and described in the following paragraphs. Table 11-1.
11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device Q ■ Hard Loop ID. If the Enable HBA Port Hard Loop ID setting is enabled, the HBA attempts to use the ID specified in this setting. The default ID is 0. ■ Loop Reset Delay. After resetting the loop, the firmware refrains from initiating any loop activity for the number of seconds specified in this setting. The default is 5 seconds. ■ Enable HBA Port BIOS.
Q 11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device For QLA200 HBAs, see figure 11-4. Parameters that are not supported for the HBA do not display; parameters that cannot be modified appear dimmed. Figure 11-6. Settings Tabbed Page (Advanced HBA Port Settings) for QLA200 HBAs NOTE: FS0054603-00 C You must reboot the HBA for the changes to take effect.
11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device Q The default settings for the QLA200/QLA2xxx HBA are listed in table 11-2 and described in the following paragraphs. Table 11-2.
Q 11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device ■ Operation Mode (Windows 2000/Windows Server 2003 and Red Hat/SuSE Linux). This setting specifies the reduced interrupt operation (RIO) modes, if supported by the software driver. RIO modes allow posting multiple command completions in a single interrupt. The default is 0 — Interrupt for every I/O completion. This setting applies to the QLA23xx HBA.
11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device Q ■ Enable Target Reset. This setting enables the drivers to issue a Target Reset command to all devices on the loop when a SCSI Bus Reset command is issued. The default is disabled. ■ Fast Error Reporting (Solaris SPARC). This setting instructs the driver to remove the delay between I/O command errors sent during a loop down condition. The default is disabled. ■ Link Down Error (Solaris SPARC).
Q 11 – Updating the HBA Updating the HBA Port Settings, Advanced HBA Port Settings, and Boot Device You can select how the operating system selects a boot device. There are two options: selectable boot and primary boot port name. Do one of the following: ■ Selectable Boot. Use selectable boot if you want the operating system to boot from the first target the BIOS finds. NOTE: This option is not available on Solaris SPARC. Do the following: 1. Enable the Selectable Boot check box. 2.
11 – Updating the HBA Restoring Default NVRAM Settings from a File Q bound with the given target ID (in the NVRAM). The corresponding target ID is taken; you cannot assign the same target ID to another target on the same HBA. 11.2 Restoring Default NVRAM Settings from a File WARNING!! Changing NVRAM incorrectly can cause serious damage to your system. Perform the following steps to restore the default NVRAM settings from a file: 1.
Q 11 – Updating the HBA Updating the Flash BIOS from a File NOTE: If you selected multiple HBA ports, the Save NVRAM, Save BIOS (Windows 2000/Windows Server 2003, Red Hat/SuSE Linux), and Save FCode (Solaris SPARC) buttons do not display. These options cannot be performed with multiple HBA ports. The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. Name of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name.
11 – Updating the HBA Updating the Flash BIOS from a File Q Perform the following steps to update the flash BIOS: 1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA port. If you want to configure multiple HBA ports with the same settings, hold the CTRL key while selecting multiple HBA ports. The HBAs must be in the same series, for example: QLA231x HBAs, QLA234x HBAs, or QLA22xx HBAs.
Q 11 – Updating the HBA Updating the Flash BIOS from a File The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. Name of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name. World wide HBA port name Port ID. Port ID of the HBA 3. Click the Update Flash button. 4. Select the file that contains the flash BIOS. You can obtain this file from the QLogic Web site or service personnel. The file typically ends with .
Q 11 – Updating the HBA Updating the FCode 11.4 Updating the FCode NOTE: The SANsurfer FC HBA Manager update FCode feature is available only on Solaris SPARC systems. It is not available on Windows 2000/Windows Server 2003, NetWare, nor Red Hat/SuSE Linux (the Update FCode button does not display on the Utilities tabbed page). Perform the following steps to update the FCode: 1. In the SANsurfer FC HBA Manager main window Manager main menu HBA tree, select the HBA port.
Q 11 – Updating the HBA Updating the FCode NOTE: If you selected multiple HBA ports, the Save NVRAM, Save BIOS (Windows 2000/Windows Server 2003 and Red Hat/SuSE Linux), and Save FCode (Solaris SPARC) buttons do not display. These options cannot be performed with multiple HBA ports. The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. Name of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name.
11 – Updating the HBA Saving NVRAM, Flash BIOS, and FCode Q 11.5 Saving NVRAM, Flash BIOS, and FCode NOTE: Saving NVRAM and flash BIOS are not available on a NetWare system (the Save NVRAM and Save FLASH buttons appear dimmed on the Utilities tabbed page). Perform the following steps to save the current NVRAM, Flash BIOS, or FCode to a file. 1. In the SANsurfer FC HBA Manager main window HBA tree, select the HBA port. NOTE: You cannot save the NVRAM, flash BIOS, or FCode for multiple HBAs. 2.
Q 11 – Updating the HBA Saving NVRAM, Flash BIOS, and FCode The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. Name of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name. World wide HBA port name Port ID. Port ID of the HBA port 3.
Q 11 – Updating the HBA Updating the HBA Driver 11.6 Updating the HBA Driver NOTE: The SANsurfer FC HBA Manager HBA driver update feature is available only on Windows 2000/Windows Server 2003 systems. It is not available on Red Hat/SuSE Linux nor NetWare (the Update Driver button does not display on the Utilities tabbed page). Perform the following steps to update the HBA driver. If you select a QLA23xx HBA, all QLA23xx HBAs on the host will use the same driver.
Q 11 – Updating the HBA Updating the HBA Driver The identifying information displays: ❑ ❑ ❑ ❑ ❑ ❑ Hostname. Name of the host connected to the HBA HBA Model. The QLA200/QLA2xxx HBA Port. HBA port number Node Name. World wide HBA node name Port Name. World wide HBA port name Port ID. Port ID of the HBA port 3. Click the Update Driver button. 4. The Select Driver dialog box displays (see figure 11-13). Figure 11-13.
Q 11 – Updating the HBA Updating the HBA Driver ❑ To update the HBA driver from the QLogic Web site when your network requires proxy settings to access the Internet, do the following: a. Select the From the QLogic Web site radio button. Select the Specify Proxy Settings check box. Click Continue. b. The Server Proxy Settings dialog displays (see figure 11-14). Figure 11-14.
Q 11 – Updating the HBA Updating the HBA Driver 7. When complete, the driver update complete message displays (see figure 11-15). Click OK. Figure 11-15. Driver Update Complete Message 8. If prompted in step 7, reboot the system.
11 – Updating the HBA Updating the HBA Driver Q Notes 11-26 FS0054603-00 C
Section 12 Troubleshooting Problems can occur when installing and using the SANsurfer FC HBA Manager application. This section discusses: ■ Troubleshooting problems and solutions (see section 12.1) ■ Tracing SANsurfer FC HBA Manager GUI and agent activity (debug), as directed by technical support (see section 12.2) The qlremote agent refers to the SANsurfer FC HBA Manager server agent (SANsurfer Windows NT 4/2000/2003 agent, SANsurfer Linux agent, SANsurfer Solaris agent, or SANsurfer NetWare 5/6.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution Installation does not copy files Cause: There is insufficient disk space or not enough available memory. Solution: The installation detects when there is insufficient disk space. Once sufficient disk space is available, continue the installation. For disk space and physical RAM requirements, see section 4.1 or the readme.txt file.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem SANsurfer FC HBA Manager GUI cannot connect to the local host Cause and Solution Cause: The HBA driver is not installed. Solution: ■ Verify that the HBA driver is installed: ■ For Windows 2000/Windows Server 2003, do the following: (1) Right click the My Computer desktop icon. From the pop-up menu, click Manage.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution SANsurfer FC HBA Manager GUI cannot connect to a remote host Cause: The qlremote agent is not installed on the remote system or the network protocol is not properly configured. SANsurfer FC HBA Manager cannot disconnect from a remote host Cause: The qlremote agent service has stopped or is unable to establish a network link.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution SANsurfer FC HBA Manager GUI does not find/display any devices Cause: The operating system driver did not find devices during the initial load. SANsurfer FC HBA Manager GUI reports that the HBA device driver is invalid or incorrect Cause: An incorrect or unsupported operating system driver is installed.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution SANsurfer FC HBA Manager GUI loses the connection to a host Cause: There is a disconnect with the qlremote agent or network communication has stopped. Solution: ■ Verify that qlremote is installed and running: ■ For Windows 2000/Windows Server 2003, open the Services window and verify that the QLogic Management Suite Java agent service is running.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution SANsurfer FC HBA Manager GUI crashes Cause: SANsurfer FC HBA Manager GUI lost communication with the qlremote agent, another application caused a conflict with SANsurfer FC HBA Manager, or an operating system driver lost communication with the HBA or device.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Unable to get host Information Cause and Solution Cause: The qlremote agent is not running or installed. Solution: Verify that the qlremote agent is installed and running: ■ For Windows 2000/Windows Server 2003, open the Services window and verify that the QLogic Management Suite Java agent service is running.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Unable to run update flash BIOS Unable to run the loopback test Cause and Solution Cause: This feature is not supported for all operating systems. Solution: The Update Flash utility is available only for Windows 2000/Windows Server 2003 and Red Hat/SuSE Linux. Cause: A loopback connector was not attached to the Fibre Channel connector on the HBA.
Q 12 – Troubleshooting Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) 12.2 Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) Additional information may be required to help troubleshoot SANsurfer FC HBA Manager application problems. Once debug has been enabled following the steps in this section, attempt to reproduce the problem so that SANsurfer FC HBA Manager GUI and agent activity can be captured.
Q 12 – Troubleshooting Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) 2. Edit the SANsurfer.lax file, which is located where SANsurfer FC HBA Manager is installed. Do one of the following: ❑ Edit the file so that the information displays on the console. Change the following properties: lax.stderr.redirect=console lax.stdout.redirect=console lax.stdin.redirect=console ❑ Edit the file so that the information is saved to a file.
12 – Troubleshooting Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) Q See figure 12-2 for an example. Figure 12-2. SANsurfer.
Q 12 – Troubleshooting Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) 3. If you are using a Windows 2000/Windows Server 2003 system, do the following to change the height of the screen buffer: a. Click the Start button, point to Programs, point to Accessories, and select Command Prompt. b. The Command Prompt window displays. Click the upper left corner of the title bar. c. From the pop-up menu, select Properties. d. The “Command Prompt” Properties dialog box displays (see figure 12-3).
Q 12 – Troubleshooting Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) 12.2.2 Exporting or Saving Agent Activity Logs This section discusses: ■ ■ The agent logs (see section 12.2.2.1) Exporting or saving the agent logs (see section 12.2.2.2) 12.2.2.1 The Agent Logs Agent activity automatically logs to one of the following. The name and location of the log differs, depending on the type of system. ■ ■ ■ ■ Windows 2000/Windows Server 2003. Event Viewer Red Hat/SuSE Linux.
Q 12 – Troubleshooting Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) From a Solaris SPARC system, do the following to export agent activity: 1. Open a terminal (for example, xterm or dtterm). 2. Do the following to stop the currently running qlremote agent: a. Type the following and then press ENTER to determine the process identifier (pid) of qlremote: # ps -ef | grep qlremote The pid displays, as in the following example. Note that in the example, the pid is 227.
12 – Troubleshooting Tracing SANsurfer FC HBA Manager GUI and Agent Activity (Debug) Q Notes 12-16 FS0054603-00 C
Appendix A Frequently Asked Questions Table A-1 lists some frequently asked questions (FAQs) about the SANsurfer FC HBA Manager application. Table A-1. Frequently Asked Questions Question Answer On what platforms does SANsurfer FC HBA Manager run? The SANsurfer FC HBA Manager GUI runs on any platform that supports the Java JVM 1.3 specification. The agent runs only on Windows 2000/Windows Server 2003, Solaris SPARC, Red Hat/SuSE Linux, and NetWare.
A – Frequently Asked Questions Q Notes A-2 FS0054603-00 C
Appendix B Glossary This section describes common hardware, software, and Fibre Channel terms that are used in the SANsurfer FC HBA Manager. Adapter See HBA. AL_PA AL_PA stands for arbitrated loop_physical address. This is a low-level address on the Fibre Channel loop. Arbitrated loop An arbitrated loop is a non-point-to-point circular topology where two or more ports can be interconnected, but only two ports can communicate at one time.
Q B – Glossary Driver Driver refers to software that interfaces between the file system and a physical data storage device or network media. The level structure for Windows 2000/Windows Server 2003 drivers is as follows: ■ Class Driver. This is the highest driver level. There is a separate class for disk, Ethernet, etc. This level handles all generic aspects of operations for that class. ■ Port Driver.
Q B – Glossary Driver (continued) In Red Hat/SuSE Linux, the driver layers include: ■ SCSI Upper Layer. This is the device management layer. It handles device-dependent tasks for devices, such as disks and tapes. ■ SCSI Middle Layer. This is the SCSI traffic handling layer. It directs requests between the kernel and the SCSI. ■ SCSI Lower Layer. This is the SCSI host bus adapter driver. It communications directly to the SCSI HBA. The structure for Solaris SPARC drivers includes: ■ Nexus Drivers.
Q B – Glossary B-4 HBA Host bus adapter. An HBA is the board that interfaces between the host system and device. HBA is synonymous with host adapter, adapter, and adapter board. In SANsurfer FC HBA Manager documentation, the term QLA200/QLA2xxx HBA is used. HBA alias A user-defined name for an HBA. HBA port An HBA port is port on the HBA. HBA port alias A user-defined name for an HBA port.
Q B – Glossary Media Media are carriers of information. Fibre Channel supports several different physical media: copper, multimode optical, and single-mode optical, which differ mainly in the maximum cable length. All Fibre Channel protocols are supported on all media. NIC NIC stands for network interface controller. NVRAM NVRAM stands for nonvolatile random access memory. NVRAM configuration settings are stored in NVRAM. You can configure NVRAM settings or restore them from a file.
Q B – Glossary B-6 Port Ports are access points in a device where a link attaches. There are four types of ports, as follows: N_Port is a Fibre Channel device port that supports point-to-point topology. NL_Port is a Fibre Channel device port that supports loop topology. F_Port is a port in a fabric where an N_Port can attach. FL_Port is a port in a fabric where an NL_Port can attach.
Appendix C Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic HBA products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. Visit the QLogic support Web site listed in section C.3 for the latest firmware and software updates. C.
Q C – Technical Support Contact Information C-2 Email: Technical Service Technical Training support@qlogic.com tech.training@qlogic.com HBA Support Web Site: support.qlogic.
Appendix D Contacting QLogic For product information, our latest drivers, and links for technical assistance, please visit QLogic’s Web site at: www.qlogic.com. If you are using the SANsurfer FC HBA Manager GUI and have Internet access, you can connect to QLogic’s Web site by clicking the QLogic logo on the right side of the SANsurfer FC HBA Manager main window toolbar.
D – Contacting QLogic Q Notes D-2 FS0054603-00 C
