Q Simplify SANsurfer iSCSI HBA Application User’s Guide Management Application for SANsurfer iSCSI Host Bus Adapters IS0054602-00 A Page i
Q SANsurfer iSCSI HBA Application User’s Guide Management Application for SANsurfer iSCSI 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.
Table of Contents Section 1 Introduction 1.1 Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.3 2.3.1 2.3.2 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1: Collect the Hardware and Software . . . .
SANsurfer iSCSI HBA Application User’s Guide Management Application for SANsurfer iSCSI Host Bus Adapters Q Section 6 Getting Started 6.1 6.1.1 6.7.3 6.8 Starting the SANsurfer iSCSI HBA Manager GUI. . . . . . . . . . . . . . . . . . . Starting SANsurfer iSCSI HBA Manager on Windows 2000/ Windows Server 2003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Starting SANsurfer on Red Hat/SuSE Linux or Solaris SPARC . . . . . SANsurfer iSCSI HBA Manager Main Window. . . . . . . .
Q SANsurfer iSCSI HBA Application User’s Guide Management Application for SANsurfer iSCSI Host Bus Adapters SANsurfer iSCSI HBA 7.2.3 7.2.3.1 7.2.3.2 7.2.4 7.2.5 7.3 7.3.1 7.3.2 7.3.3 7.3.4 Setting the DNS Server Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting the DNS Server Address Automatically . . . . . . . . . . . . . . . . Setting the DNS Server Address Manually . . . . . . . . . . . . . . . . . . . Enabling SLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANsurfer iSCSI HBA Application User’s Guide Management Application for SANsurfer iSCSI Host Bus Adapters Q Section 12 Troubleshooting 12.1 12.2 12.2.1 12.2.2 12.2.3 12.2.3.1 12.2.3.2 Troubleshooting Problems and Solutions . . . . . . . . . . . . . . . . . . . . . . . . . Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) Retrieving the HBA Crash Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tracing SANsurfer iSCSI HBA Manager GUI Activity . . . . . . . . . . . . .
Q 6-5 6-6 6-7 6-8 6-9 6-10 6-11 6-12 6-13 7-1 7-2 7-3 7-4 7-5 8-1 8-2 9-1 9-2 9-3 9-4 9-5 9-6 9-7 10-1 10-2 10-3 10-4 10-5 10-6 11-1 11-2 11-3 11-4 11-5 11-6 11-7 11-8 11-9 11-10 SANsurfer iSCSI HBA Application User’s Guide Management Application for SANsurfer iSCSI Host Bus Adapters SANsurfer iSCSI HBA Security Tabbed Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10 HBA Tree with HBA iSCSI Names and Target iSCSI Names . . . . . . . . . . . . . . . .
SANsurfer iSCSI HBA Application User’s Guide Management Application for SANsurfer iSCSI Host Bus Adapters 11-11 11-12 11-13 11-14 11-15 11-16 11-17 12-1 12-2 12-3 12-4 12-5 12-6 Q Open Dialog Box (Firmware) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HBA Options Tabbed Page (Firmware Tab) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Driver Update Warnings Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Section 1 Introduction The SANsurfer iSCSI HBA Applications User’s Guide describes the SANsurfer® iSCSI HBA Manager application, a component of QLogic® SANsurfer software. SANsurfer iSCSI HBA Manager is a comprehensive application for configuration and management of QLogic SANsurfer iSCSI host bus adapters (HBAs) used in storage area networks (SANs). NOTE: HBA and adapter are used interchangeably. The contents of this user’s guide are described in the following paragraphs: ■ Section 1—Introduction.
Q 1 – Introduction Related Documents ■ Section 11—Updating the HBA. This section discusses updating the HBA firmware, driver, ROM, and BIOS. ■ Section 12—Troubleshooting. This section presents common troubleshooting questions and answers. It also provides the procedures for tracing SANsurfer iSCSI HBA Manager GUI and agent activity, if directed to do so by technical support. ■ Appendix A—Frequently Asked Questions.
Section 2 System Overview 2.1 Introduction SANsurfer iSCSI 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 iSCSI 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.
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 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 utility. Type ALT+Q or CTRL+Q during power up to enter Fast!UTIL. Fast!UTIL allows you to perform basic HBA configuration.
Q 2 – System Overview Troubleshooting 2.2.4 Step 4: Install and Run the SANsurfer iSCSI HBA Manager SANsurfer iSCSI HBA Manager is a management application to view, manage, and diagnose QLogic HBAs. SANsurfer iSCSI HBA Manager also configures HBAs and target devices on the HBAs. See section 5 for complete installation instructions.
Q 2 – System Overview Troubleshooting 2.3.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 iSCSI HBA Manager agents also use the application event log to report service errors, etc. The miniport driver logs events for significant driver errors.
2 – System Overview Troubleshooting Q Notes 2-6 IS0054602-00 A
Section 3 SANsurfer iSCSI HBA Manager Overview 3.1 What is SANsurfer iSCSI HBA Manager? The QLogic SANsurfer iSCSI HBA Manager is a GUI-based application that configures and manages both QLogic iSCSI host bus adapters and their attached devices within a storage area network (SAN) environment. Note the following: ■ SANsurfer iSCSI HBA Manager works with the Windows® 2000, Windows® Server 2003, Red Hat™ Linux®, SuSE Linux, and Solaris SPARC® operating systems.
3 – SANsurfer iSCSI HBA Manager Overview Features ■ ■ 3-2 Q Diagnostics. SANsurfer iSCSI HBA Manager provides diagnostics that enable you to test the HBAs and the devices to which they are connected.
Section 4 System Requirements The SANsurfer iSCSI 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 QLA4xxx iSCSI to PCI-X host bus adapters (see section 4.
4 – System Requirements Software Requirements Q 4.2 Software Requirements The minimum software requirements are as follows: ■ One of the following operating systems: ❑ ❑ ❑ ❑ ❑ Windows 2000 Server or Advanced Server (SP4) Windows Server 2003 Standard Edition or Enterprise Edition (IA32) Red Hat Enterprise Linux Advanced Server (AS) 2.1 or 3.0 (IA32) SuSE Linux Enterprise Server 8 (SLES) (IA32) Solaris SPARC v2.8 or 2.
Section 5 Installing SANsurfer iSCSI HBA Manager Installing the SANsurfer iSCSI HBA Manager application consists of installing the SANsurfer iSCSI HBA Manager GUI, platform-specific agent, and help components, as appropriate. NOTE: Before installing SANsurfer iSCSI 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 application (see section 5.2) 5.
Q 5 – Installing SANsurfer iSCSI HBA Manager Initial Installation 5.1.1 Installation Options SANsurfer iSCSI 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 system monitors QLA4xxx HBAs locally.
Q 5 – Installing SANsurfer iSCSI HBA Manager Initial Installation 5.1.2 Installation Instructions NOTE: This section assumes that you may be installing all SANsurfer software components on any of the supported operating systems. References to Solaris x86 and Novell® NetWare® do not apply to the SANsurfer iSCSI HBA Manager application. SANsurfer installer is a self-extracting program that installs the SANsurfer software, including the SANsurfer iSCSI HBA Manager application and related software.
5 – Installing SANsurfer iSCSI HBA Manager Initial Installation Q ❑ Click the appropriate operating system under the Drivers and Management Software heading. ❑ In the SANsurfer row of the table (SANsurfer for Windows, SANsurfer for Linux, or SANsurfer for Solaris), click Download. ❑ The File Download dialog box displays. Click Save. Select a directory on your system and download the file. b. Do one of the following to select and start the installation file. install is the SANsurfer installer file.
Q 5 – Installing SANsurfer iSCSI 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.
5 – Installing SANsurfer iSCSI HBA Manager Initial Installation Q 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/x86 systems.
Q 5 – Installing SANsurfer iSCSI HBA Manager Initial Installation ❑ ❑ Select SANsurfer Switch Manager GUI to install only the SANsurfer Switch Manager GUI. For more information, see the appropriate SANbox switch management user’s guide (see section 1.1). ❑ Select iSCSI GUI and Agent to install the SANsurfer iSCSI HBA Manager GUI, including the iSCSI (Windows, Linux, or Solaris) agent.
Q 5 – Installing SANsurfer iSCSI HBA Manager Initial Installation ❑ ❑ SANsurfer iSCSI Windows Agent Help For a Red Hat/SuSE Linux system: ❑ ❑ ❑ ❑ ❑ ❑ SANsurfer FC HBA Manager SANsurfer iSCSI HBA Manager SANsurfer Switch Manager GUI SANsurfer FC Linux Agent SANsurfer iSCSI Linux Agent Help For a Solaris SPARC/x86 system: ❑ ❑ ❑ ❑ ❑ ❑ SANsurfer FC HBA Manager SANsurfer iSCSI HBA Manager SANsurfer Switch Manager GUI SANsurfer FC Solaris Agent SANsurfer iSCSI Solaris Agent Help c. Click Next. 5.
Q 5 – Installing SANsurfer iSCSI 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 iSCSI HBA Manager Initial Installation Q If there is a previous version of the SANsurfer application on the system, the installation procedures prompt the old version to be uninstalled. Uninstall the older version; the new version is not compatible with the older version. Do the following: ❑ If the SANsurfer application is currently running, exit the SANsurfer application before proceeding with the installation.
Q 5 – Installing SANsurfer iSCSI HBA Manager Initial Installation Perform the following steps: a. Do one of the following: ❑ Click All Users Profile if you want the application shortcuts available to all users. ❑ Click Current Users Profile (default) if you want the application shortcuts available only to the current user. b. Click Next. 8.
5 – Installing SANsurfer iSCSI HBA Manager Initial Installation Q 9. The Pre-Installation Summary dialog box displays (see figure 5-9). Review the information. Click Previous if you want to change anything. Click Install to continue. Figure 5-9. Pre-Installation Summary Dialog Box 10. The Installing SANsurfer dialog box displays (see figure 5-10). Various screens inform you that the installation is progressing. Figure 5-10.
Q 5 – Installing SANsurfer iSCSI HBA Manager Initial Installation 11. If you are installing NetWare, the Novell NetWare Disk Selection dialog box displays (see figure 5-11). Figure 5-11. Novell NetWare Disk Selection Dialog Box 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.
5 – Installing SANsurfer iSCSI HBA Manager Initial Installation Q 12. If you are installing the SANsurfer FC HBA Manager on a Windows 2000/Windows Server 2003, Novell NetWare, or Red Hat/SuSE Linux system, the Default Failover Enable/Disable dialog box displays (see figure 5-12). Figure 5-12. Default Failover Enable/Disable Dialog Box The failover path software feature ensures data availability and system reliability by assigning alternate path and automatic HBA failover for device resources.
Q 5 – Installing SANsurfer iSCSI HBA Manager Uninstalling the SANsurfer Application 13. The Install Complete dialog box displays (see figure 5-13). Click Done. Figure 5-13. Install Complete Dialog Box 14. Customize the SANsurfer iSCSI HBA Manager application and set your security parameters (see section 6). 5.2 Uninstalling the SANsurfer Application Perform the following steps to uninstall the entire SANsurfer software (including SANsurfer iSCSI HBA Manager) or specific features from this system.
Q 5 – Installing SANsurfer iSCSI HBA Manager Uninstalling the SANsurfer Application 1. Do one of the following to start the SANsurfer Uninstaller: From a Windows 2000/Windows Server 2003 system, do one of the following: ❑ Click the Start button, point to Programs, point to QLogic Management Suite, and then click SANsurfer Uninstaller. ❑ Perform the following steps to use Add/Remove Programs: a. Click the Start button, point to Settings, and then click Control Panel. b.
Q 5 – Installing SANsurfer iSCSI HBA Manager Uninstalling the SANsurfer Application From a Red Hat/SuSE Linux or Solaris SPARC/x86 system, do one of the following and then press ENTER: ❑ On a Red Hat/SuSE Linux system, if /usr/local/bin is in the path, type SANsurferUninstaller. ❑ On a Solaris SPARC/x86 system, if /usr/bin is in the path, type SANsurferUninstaller. ❑ On a Red Hat/SuSE Linux or Solaris SPARC/x86 system, do the following if none of the above are in the path: a.
5 – Installing SANsurfer iSCSI HBA Manager Uninstalling the SANsurfer Application Q 3. The Uninstall Options dialog box displays (see figure 5-16). Figure 5-16. Uninstall Options Dialog Box You can uninstall the entire SANsurfer application or specific features. Do one of the following: 5-18 ❑ Select Complete Uninstall to remove all features and components of the SANSurfer application that were installed by InstallAnywhere. This will not affect files and folders created after the installation.
Q 5 – Installing SANsurfer iSCSI HBA Manager Uninstalling the SANsurfer Application Figure 5-17. 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).
5 – Installing SANsurfer iSCSI HBA Manager Uninstalling the SANsurfer Application ❑ ❑ Q SANsurfer iSCSI Solaris Agent Help b. Click Uninstall. 4. The Uninstall Component List dialog box lists the components to be uninstalled (see figure 5-18). Figure 5-18. Uninstall Component List Dialog Box A message displays asking you to wait the while the uninstaller removes the components.
Q 5 – Installing SANsurfer iSCSI HBA Manager Uninstalling the SANsurfer Application 5. The Uninstall Complete dialog box informs you that the uninstall is complete (see figure 5-19). Click Done. Figure 5-19. Uninstall Complete Dialog Box 6. If any items were not successfully uninstalled, remove them. Some files and directories remain after uninstalling SANsurfer. These components must be deleted manually from the computer’s hard disk where SANsurfer was installed.
5 – Installing SANsurfer iSCSI HBA Manager Uninstalling the SANsurfer Application Q Notes 5-22 IS0054602-00 A
Section 6 Getting Started This section includes the procedures for starting the SANsurfer iSCSI HBA Manager GUI, exiting the SANsurfer iSCSI HBA Manager GUI, and customizing the application options. This section discusses: ■ Starting the SANsurfer iSCSI HBA Manager GUI (see section 6.1) ■ SANsurfer iSCSI HBA Manager main window (see section 6.2) ■ Exiting the SANsurfer iSCSI HBA Manager GUI (see section 6.3) ■ Getting help (see section 6.
Q 6 – Getting Started Starting the SANsurfer iSCSI HBA Manager GUI 6.1.1 Starting SANsurfer iSCSI 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 application, which includes the SANsurfer iSCSI HBA Manager GUI. When done, the SANsurfer application GUI displays; click the iSCSI HBA tab to select the SANsurfer iSCSI HBA Manager main window (see section 6.2).
Q 6 – Getting Started SANsurfer iSCSI HBA Manager Main Window 3. Do one of the following and then press ENTER: ❑ On a Red Hat/SuSE Linux system, if /usr/local/bin is in the path, type SANsurfer ❑ On a Solaris SPARC system, if /usr/bin is in the path, type SANsurfer. ❑ On a Red Hat/SuSE Linux or Solaris SPARC system, do the following if none of the above are in the path: a. Change to the directory where the SANsurfer application is installed. The default location is /opt/QLogic_Corporation/SANsurfer.
6 – Getting Started SANsurfer iSCSI HBA Manager Main Window Q The window consists of the following sections: ■ ■ ■ ■ ■ ■ ■ Application tabs Title bar Menu bar Toolbar HBA tree Tabbed pages Status line An application tab displays only when the SANsurfer software for that application has been installed on the system (see section 5.1.2). The tabs and their applications are as follows. (To use the SANsurfer iSCSI HBA Manager, select the iSCSI HBA tab.) iSCSI HBA tab. SANsurfer iSCSI HBA Manager FC HBA tab.
Q 6 – Getting Started SANsurfer iSCSI HBA Manager Main Window The icon is: ■ 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. HBA icons and text. The HBA tree displays the following: ■ HBA port iSCSI name or HBA port iSCSI alias name (see section 6.6) ■ HBA port state: the most severe displays—bad, unknown, warning, good.
Q 6 – Getting Started Exiting the SANsurfer iSCSI HBA Manager GUI LUN icons and text. The HBA tree displays the following information: ■ LUN number (LUN n) Example: LUN (LUN 1) The LUN icon is: ■ LUN 6.3 Exiting the SANsurfer iSCSI HBA Manager GUI Do one of the following to exit the SANsurfer iSCSI HBA Manager GUI: ■ ■ On the SANsurfer iSCSI HBA Manager main window File menu, select Exit. Click the close (x) button in the upper right-hand corner of the screen. 6.
Q 6 – Getting Started Getting Help with the SANsurfer iSCSI HBA Manager GUI 6.4.2 Specifying the Browser Location Perform the following steps to specify the location of the browser SANsurfer iSCSI HBA Manager launches when you select to view the online help (see section 6.4.1): 1. On the SANsurfer iSCSI HBA Manager main window Help menu, click Set Browser Location. The Browser Location dialog box displays (see figure 6-3). Figure 6-3. Browser Location Dialog Box 2.
Q 6 – Getting Started Getting Help with the SANsurfer iSCSI HBA Manager GUI 6.4.3 Viewing SANsurfer iSCSI HBA Manager Software Information To view information about the SANsurfer iSCSI HBA Manager application software, on the SANsurfer iSCSI HBA Manager main window Help menu, click About. The About SANsurfer iSCSI HBA Manager window displays (see figure 6-4). Figure 6-4.
Q 6 – Getting Started Setting SANsurfer iSCSI HBA Manager Security 6.5 Setting SANsurfer iSCSI HBA Manager Security SANsurfer iSCSI HBA Manager security ensures that HBA configuration changes require password authorization. SANsurfer iSCSI HBA Manager prompts for the password any time you click the Save button to change the HBA configuration.
6 – Getting Started Setting SANsurfer iSCSI HBA Manager Security Q Perform the following steps to set the application access password for a host: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the host for which you want to set the application access password. 2. Click the Security tab. The Security tabbed page displays (see figure 6-5). The host name displays at the top of the tabbed page. Figure 6-5. Security Tabbed Page 3.
Q 6 – Getting Started Specifying Whether iSCSI Names or iSCSI Alias Names Display in the HBA Tree 5. Do one of the following: ❑ Click Apply to update the application access password. ❑ Click Clear Fields to clear the typed entries in the Security tabbed page text boxes. 6.6 Specifying Whether iSCSI Names or iSCSI Alias Names Display in the HBA Tree You can specify whether iSCSI or iSCSI alias names display in the HBA tree.
6 – Getting Started Specifying Whether iSCSI Names or iSCSI Alias Names Display in the HBA Tree Q See figure 6-7 for a sample HBA tree with HBA port iSCSI alias names and target iSCSI alias names. Figure 6-7. HBA Tree with HBA Port iSCSI Alias Names and Target iSCSI Alias Names Do one of the following: ■ 6-12 Right-click in the HBA tree. The drop-down menu displays.
Q 6 – Getting Started Specifying Whether iSCSI Names or iSCSI Alias Names Display in the HBA Tree ■ Do the following: 1. From the View menu, select Preferences. The Preferences dialog box displays (see figure 6-8). Figure 6-8. Preferences Dialog Box (Tree View Naming Preference) 2. In the Tree Viewing Naming Preference section Tree Naming drop-down box, select one of the following. ❑ Select Alias if you want the HBA port and target iSCSI alias names to display.
Q 6 – Getting Started Setting the Options for Retrieving Host Status Alarms and Refreshing 6.7 Setting the Options for Retrieving Host Status Alarms and Refreshing the Configuration Polling intervals determine how frequently the SANsurfer iSCSI HBA Manager monitors the connected HBAs (and their targets) and updates the SANsurfer iSCSI HBA Manager GUI configuration based on their state.
Q 6 – Getting Started Setting the Options for Retrieving Host Status Alarms and Refreshing host poll, the GUI asks the agent if anything has changed since last time it received an update. If not, the GUI waits until next poll or alarm. If something has changed, then the SANsurfer iSCSI HBA Manager then asks the GUI whether the configuration is set to update when host status alarms occur (see section 6.7.2). If selected, the agent sends updated information. 6.7.1.
6 – Getting Started Setting the Options for Retrieving Host Status Alarms and Refreshing Q 6.7.1.2 Specifying the Host Polling Interval The host polling interval is the length of time between polls to a connected host’s agent to retrieve information. Host polling detects host status alarms that were not received by SANsurfer iSCSI HBA Manager GUI. Perform the following steps to set a host’s polling interval: 1.
Q 6 – Getting Started Setting the Options for Retrieving Host Status Alarms and Refreshing 6.7.2 Specifying Whether the Configuration Refreshes when Host and Target Status Alarms Occur You can specify whether the configuration that the SANsurfer iSCSI HBA Manager GUI displays refreshes each time your system receives a host status alarm or target status alarm. Do the following: 1. From the View menu, select Preferences. The Preferences dialog box displays (see figure 6-11). Figure 6-11.
6 – Getting Started Setting the Options for Retrieving Host Status Alarms and Refreshing Q 6.7.3 Specifying Whether the Host Refresh Prompt Displays You can determine whether the iSCSI configuration change message displays when the host configuration has changed. 1. From the View menu, select Preferences. The Preferences dialog box displays (see figure 6-12). Figure 6-12. Preferences Dialog Box (Prompting Behavior) 2.
Q 6 – Getting Started Refreshing the Configuration Immediately ❑ If you do not want the configuration message to display when a host configuration has changed, clear the Enable Prompt to Accept Host Refresh check box. The configuration refreshes if it is set to update when host status alarms occur (see section 6.7.2). 3. Click OK to save your changes. Click Cancel to exit the Preferences dialog box without making any changes. 6.
6 – Getting Started Refreshing the Configuration Immediately Q Notes 6-20 IS0054602-00 A
Section 7 Setting Up Connections You can connect to and configure local and remote systems. This section discusses: ■ ■ ■ Connecting to hosts (see section 7.1) Configuring the QLA4xxx HBA port (see section 7.2) Configuring targets (see section 7.3) 7.1 Connecting to Hosts The SANsurfer iSCSI HBA Manager GUI tries to ensure that a host is not loaded more than once into the HBA tree.
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 iSCSI 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: 7-2 ❑ Click Connect to initiate the connection.
Q 7 – Setting Up Connections Connecting to Hosts 7.1.2 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.2.1) Using a host group file to connect to hosts (see section 7.1.2.2) 7.1.2.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.2.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 iSCSI HBA Manager main window Host menu, click Open Group. ❑ Right-click the HBA tree. From the pop-up menu, click Open Group. 2. The Open dialog box displays. Select the host group file (.hst) that contains the hosts to which you want to connect.
Q 7 – Setting Up Connections Configuring the QLA4xxx HBA Port 7.2 Configuring the QLA4xxx HBA Port Configuring the QLA4xxx HBA port includes the following: ■ ■ ■ ■ ■ Configuring the HBA port iSCSI name and HBA port iSCSI alias name Setting the IP address Setting the domain name system (DNS) server address Enabling service locator protocol (SLP) Enabling Internet storage name service (iSNS) Perform the following steps to configure an HBA port: 1.
7 – Setting Up Connections Configuring the QLA4xxx HBA Port Q The HBA port information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state. See section 8.1 for details about the HBA port state and its correspondence with the HBA icons. ❑ ❑ ❑ ❑ Green background: good Yellow background: warning Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name.
Q 7 – Setting Up Connections Configuring the QLA4xxx HBA Port 7.2.1 Configuring the HBA Port iSCSI Name and HBA Port iSCSI Alias Name You can modify the existing HBA port iSCSI name. You can also assign an HBA port iSCSI alias name. 7.2.1.1 Modifying the HBA Port iSCSI Name We recommend that you use the default HBA port iSCSI name as defined by QLogic manufacturing unless your system requires that you change the name.
Q 7 – Setting Up Connections Configuring the QLA4xxx HBA Port 7.2.2.1 Setting the IP Address Automatically To set the IP address automatically through DHCP, do the following: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. Click the HBA Options tab; then click the Network tab. The HBA Options tabbed page (Network tab) displays (see figure 7-2). 2. In the setting the IP Address section, select the Obtain an IP address automatically (DHCP) option button. 7.2.2.
Q 7 – Setting Up Connections Configuring the QLA4xxx HBA Port 7.2.3.1 Setting the DNS Server Address Automatically NOTE: You must select the setting the IP address section Obtain an IP address automatically (DHCP) option button to set the DNS server address automatically. To set the DNS server address automatically through DHCP, do the following: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. Click the HBA Options tab; then click the Network tab.
Q 7 – Setting Up Connections Configuring the QLA4xxx HBA Port Perform the following steps to enable SLP: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. Click the HBA Options tab; then click the Network tab. The HBA Options tabbed page (Network tab) displays (see figure 7-2). 2. In the Network tab enable SLP section, do the following: a. Select the Enable SLP check box. b. Set the directory agent (DA) address automatically, manually, or through the discovery process.
Q 7 – Setting Up Connections Configuring Targets 7.3 Configuring Targets After configuring the QLA4xxx HBA, you can configure iSCSI targets. When the QLA4xxx HBA arrives from the factory, there are no targets listed. Add iSCSI targets by either entering specific iSCSI target information (IP address and iSCSI name, see section 7.3.2) or by entering the target IP address and discovering the devices behind that address (see section 7.3.1). Perform the following steps to configure targets: 1.
Q 7 – Setting Up Connections Configuring Targets ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name. HBA port iSCSI alias name. Symbolic name you assign to the HBA port for identification purposes. ❑ IP Address. IP address of the HBA port The target configuration section displays the current target configuration and enables you to configure these and additional targets on this HBA port. ❑ Bind.
Q 7 – Setting Up Connections Configuring Targets 7.3.1 Configuring Targets Using Discovery The discovery method is an excellent timesaver for finding and entering iSCSI targets. You can use this method to find all available targets, delete targets you do not want, and then have access only to the remaining devices. This method prevents you from having to enter iSCSI names for each target.
Q 7 – Setting Up Connections Configuring Targets 8. If you want to enable a specific the target, select the target’s Enable Target check box. If you want to enable all the targets, right-click on any target in the table and select Enable All Devices from the pop-up menu. Conversely, if you want to disable a specific target, clear the target’s Enable Target check box. Right-click on any target in the table and select Disable All Devices from the pop-up menu if you do not want to enable any target.
Q 7 – Setting Up Connections Configuring Targets 7.3.2 Configuring Specific Targets To configure a specific iSCSI target, follow these steps: NOTE: ■ If you want to modify these parameters for an existing target, use the following procedures as appropriate (skipping steps 2 through 5). ■ If you want to delete a target, select the target and click the red minus sign (–) on the right. 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. Click the Target Settings tab.
Q 7 – Setting Up Connections Configuring Targets 11. Do one of the following: ❑ Click Save. The QLA4xxx HBA does the following: ❑ Resets (reboots the HBA only) if you have made changes to the firmware configuration parameters in section 7.3.3 ❑ Connects to the target ❑ Makes these new targets available on the Target Settings tabbed page ❑ Right-click the target and select Login/Save Device. The Security Check dialog box displays. In the Enter Password box, type the password. Click OK.
Q 7 – Setting Up Connections Configuring Targets 7.3.3 Changing the Target Configuration Parameters NOTE: If you changed HBA’s firmware configuration parameter values (see section 11.1, section 11.2, and section 11.3), a subset of those settings appear for the corresponding target configuration parameters. Changing the target configuration parameters will not change the corresponding HBA’s firmware configuration parameters. Perform the following steps to edit the target configuration parameters: 1.
7 – Setting Up Connections Configuring Targets Q For example, if you add targets, update the HBA’s firmware configuration parameter values and save them (see section 11.1), and then add additional targets, the additional targets will have the new saved HBA configured firmware default settings. The first set of added targets will have the original HBA’s configured firmware default settings that existed when they were added. 2. Select and change the desired parameters.
Q 7 – Setting Up Connections Configuring Targets 7.3.4 Authenticating Targets (CHAP) The ISP4010 firmware uses the challenge handshake authentication protocol (CHAP) as an authentication mechanism between the iSCSI initiators (QLA4xxx HBA ports) and the devices to which they are attached (targets). Authentication can be disabled or enabled for a specific target or for all targets attached to the QLA4xxx HBA port. NOTE: The targets attached to the QLA4xxx HBA port must be programmed for or support CHAP.
Q 7 – Setting Up Connections Configuring Targets The dialog box contains three sections: ❑ ❑ ❑ Set Default Initiator Name and Secret Initiator Name and Secret Target Table 4. To enable an initiator name and initiator secret, do the following: a. In the Initiator Name and Secret section, select the Enable check box for the targets for which you want to use CHAP. b. Enter the initiator name and secret you want to use in the Initiator Name box and Initiator Secret box. c. Click OK.
Q 7 – Setting Up Connections Configuring Targets 6. If the enabled targets are configured to use the same initiator name and secret, perform the following steps. Otherwise, skip to step 7. NOTE: At the time of publication, the Hex radio button and ASCII radio button are not supported. a. In the Set Default Initiator Name and Secret section, select the Set Default Initiator Name and Secret check box.
7 – Setting Up Connections Configuring Targets Q Notes 7-22 IS0054602-00 A
Section 8 Monitoring the Connections SANsurfer iSCSI HBA Manager monitors connected HBAs and their targets and informs you of their state. This section discusses: ■ ■ Monitoring the HBA port state (see section 8.1) Monitoring the target state (see section 8.2) 8.1 Monitoring the HBA Port State The HBA port state indicates the status of the HBA. The most severe state displays: bad, unknown, warning, good.
8 – Monitoring the Connections Monitoring the HBA Port State Q For example, in figure 8-1, HBA port Sys4084 is in an unknown state, as indicated by its HBA icon (blue) and the HBA port state (blue background with Ready,Link Up,Refreshing Data). Figure 8-1.
Q 8 – Monitoring the Connections Monitoring the Target State 8.2 Monitoring the Target State The target state indicates the session connection status of the device. Table 8-2 details the target state referenced in the dialog boxes and its correspondence with the device icons: Table 8-2.
Q 8 – Monitoring the Connections Monitoring the Target State For example, in figure 8-2, device 3354 has a good session connection, as indicated by its device icon (green) and the target state (green background with Session Active). Figure 8-2.
Section 9 Displaying Host, HBA Port, Device, and LUN Information You can display information about hosts, HBA ports, devices, and LUNs. This section discusses viewing information about the following: ■ Hosts —general host information (see section 9.1) ■ HBA ports —general HBA port information and HBA port statistics (see section 9.2) ■ Devices—general target information, target configuration firmware parameter settings, and LUN list (see section 9.3) ■ LUNs—general LUN information (see section 9.
9 – Displaying Host, HBA Port, Device, and LUN Information Displaying HBA Port Information Q The general information displays: ❑ ❑ ❑ ❑ ❑ ❑ Host. The name or IP address of the host connected to the HBA OS Type. Operating system running on the host OS Version. Operating system version Agent Version. SANsurfer iSCSI HBA Manager agent version SDM API Version. QLogic iSCSI SAN device management API version External IOCTL Version. QLogic external I/O control code version 9.
Q 9 – Displaying Host, HBA Port, Device, and LUN Information Displaying HBA Port Information The HBA port identifying information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state. See section 8.1 for details about the HBA port state and its correspondence with the HBA icons. ❑ ❑ ❑ ❑ Green background: good Yellow background: warning Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name.
9 – Displaying Host, HBA Port, Device, and LUN Information Displaying HBA Port Information Q 9.2.2.1 Viewing HBA Port Statistics Perform the following steps to view statistical information about an HBA port: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. 2. Select the Statistics tab. The Statistics tabbed page displays (see figure 9-3). Figure 9-3. Statistics Tabbed Page The HBA port identifying information displays: ❑ HBA. HBA instance number and HBA model ❑ State.
Q 9 – Displaying Host, HBA Port, Device, and LUN Information Displaying HBA Port Information The statistical information displays the parameters and their values. The parameters are as follows: ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ ❑ MACTxFramesCount. MAC transmitted frame count MACTxBytesCount. MAC transmitted byte count MACRxFramesCount. MAC received frame count MACRxBytesCount. MAC received byte count MACCRCErrorCount. MAC CRC error count MACEncodingErrorCount.
Q 9 – Displaying Host, HBA Port, Device, and LUN Information Displaying Device Information 9.3 Displaying Device Information You can view the following information about a device: ■ ■ ■ General target information (see section 9.3.1) Target configuration firmware parameter settings (see section 9.3.2) LUN list (see section 9.3.3) 9.3.1 Viewing General Target Information Perform the following steps to view general information about a device: 1.
Q 9 – Displaying Host, HBA Port, Device, and LUN Information Displaying Device Information ❑ ❑ Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name. HBA port iSCSI alias name. Symbolic name you assign to the HBA port for identification purposes. ❑ IP Address. IP address of the HBA port The target information displays: ❑ Product Vendor. Device manufacturer ❑ Product ID.
9 – Displaying Host, HBA Port, Device, and LUN Information Displaying Device Information NOTE: Q For information about configuring targets, see section 7.3. For information about changing the target configuration parameter values, see section 7.3.3. Except for the parameters listed in section 7.3.3, they are a subset of the firmware configuration parameters. See section 11.1 for descriptions of the firmware configuration parameters.
Q 9 – Displaying Host, HBA Port, Device, and LUN Information Displaying Device Information ❑ HBA Alias Name. HBA port iSCSI alias name. Symbolic name you assign to the HBA port for identification purposes. ❑ IP Address. IP address of the HBA port The target configuration parameter settings display: ❑ ❑ Parameter. Firmware parameter Negotiated Values for Saved Targets. Firmware parameter setting 2. From the Select Target drop-down box, select the target for which you want to display the parameters.
Q 9 – Displaying Host, HBA Port, Device, and LUN Information Displaying Device Information The target information displays: ❑ Product Vendor. Device manufacturer ❑ Product ID. Product ID of the device ❑ State. The target session connection state. See section 8.2 for details about the target state and its correspondence with the device icons. ❑ ❑ ❑ Green background: good Blue background: unknown Red background: bad ❑ Target iSCSI Name. Device iSCSI name ❑ Product Revision.
Q 9 – Displaying Host, HBA Port, Device, and LUN Information Displaying LUN Information 9.4 Displaying LUN Information Perform the following steps to view general information about a LUN: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the LUN. 2. Select the Information tab. The LUN Information tabbed page displays (see figure 9-7). Figure 9-7. LUN Information Tabbed Page The HBA port information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state.
Q 9 – Displaying Host, HBA Port, Device, and LUN Information Displaying LUN Information The target information displays: ❑ Product Vendor. Device manufacturer ❑ Product ID. Product ID of the device ❑ State. The target session connection state. See section 8.2 for details about the target state and its correspondence with the device icons. ❑ ❑ ❑ Green background: good Blue background: unknown Red background: bad ❑ Target iSCSI Name. Device iSCSI name ❑ Product Revision.
Section 10 Performing Diagnostics The following diagnostic tools are available when managing iSCSI HBAs: ■ ■ ■ Pinging a target (see section 10.1) Viewing the ARP log (see section 10.2) Viewing the connection error log (see section 10.3) 10.1 Pinging a Target Perform the following steps to ping a target. If the ping is successful, it verifies that that there is connectivity between this HBA port and the target. 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. 2.
Q 10 – Performing Diagnostics Pinging a Target The HBA port identifying information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state. See section 8.1 for details about the HBA port state and its correspondence with the HBA icons. ❑ ❑ ❑ ❑ Green background: good Yellow background: warning Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name.
Q 10 – Performing Diagnostics Viewing the ARP Log 10.2 Viewing the ARP Log The address resolution protocol (ARP) cache keeps a record of host port connections with other hardware (such as targets) on the network. The IP address/MAC address pairs are dynamic entries that are removed after 10 minutes. Perform the following steps to view the ARP log: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. 2. Click the Diagnostics tab; click the Logs tab.
Q 10 – Performing Diagnostics Viewing the ARP Log ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name. HBA port iSCSI alias name. Symbolic name you assign to the HBA port for identification purposes. ❑ IP Address. IP address of the HBA port 3. Click the Display ARP Table button. The ARP log displays (see figure 10-4). Figure 10-4.
Q 10 – Performing Diagnostics Viewing the Connection Error Log 10.3 Viewing the Connection Error Log The connection error log displays the 100 latest connection errors for this HBA port. Perform the following steps to view the connection error log: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. 2. Click the Diagnostics tab; click the Logs tab. The Diagnostics tabbed page (Logs tab) displays (see figure 10-5). Figure 10-5.
Q 10 – Performing Diagnostics Viewing the Connection Error Log ❑ HBA Alias Name. HBA port iSCSI alias name. Symbolic name you assign to the HBA port for identification purposes. ❑ IP Address. IP address of the HBA port 3. Click the Display Connection Errors button. The connection error log displays (see figure 10-6). Figure 10-6. Connection Error Log For the HBA port that you selected, the connection error log displays the following information. To view an entire entry, place the cursor on it.
Section 11 Updating the HBA You can configure and restore an HBA’s firmware. You can also update an HBA with new firmware, driver, ROM, and BIOS. This section discusses: ■ ■ ■ ■ ■ ■ Configuring an HBA’s firmware values (see section 11.1) Restoring an HBA’s factory default firmware values (see section 11.2) Updating an HBA with new firmware (see section 11.3) Updating an HBA with new ROM (see section 11.4) Updating the HBA driver (see section 11.5) Updating the BIOS from a file (see section 11.6) 11.
11 – Updating the HBA Configuring an HBA’s Firmware Values Q The HBA port information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state. See section 8.1 for details about the HBA port state and its correspondence with the HBA icons. ❑ ❑ ❑ ❑ Green background: good Yellow background: warning Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name.
Q 11 – Updating the HBA Configuring an HBA’s Firmware Values 3. To change a subset of these values, click Edit. A dialog box displays with the parameters that can be changed (see figure 11-3). Figure 11-3. Firmware Parameters Dialog Box 4. Select and change the desired parameters, explained in the following paragraphs. To view the full name of the parameter, place the cursor on it. When you are done changing the parameters, click OK.
11 – Updating the HBA Configuring an HBA’s Firmware Values Q In initiator mode, when this value is nonzero, the firmware limits the number of outstanding commands to the smaller of this value and the number of commands advertised by the target's MaxCmdSN value. 11-4 ❑ Device Timeout. When this check box is selected, the QLA4xxx HBA firmware ignores the IOCB command timeout values specified by the host. ❑ MaxBurstLength.
Q IS0054602-00 A 11 – Updating the HBA Configuring an HBA’s Firmware Values ❑ Connection Keep Alive Timeout. This column indicates the time interval (in seconds) between connection keep-alive pings. When a connection is idle for the connection keep-alive timeout interval, the QLA4xxx HBA sends an NOP ping to the other device that is part of the connection. When the device responses to the ping, the connection remains open.
Q 11 – Updating the HBA Configuring an HBA’s Firmware Values 5. The save firmware parameters message displays (see figure 11-4). Click OK. Figure 11-4. Save Firmware Parameters Message NOTE: The revised settings do not apply to currently configured targets. To apply the revised settings to a configured target, you must delete and configure the target after the HBA is reset. 6. The Firmware Parameters dialog box still displays. Click Close. 7. Save the changes (the HBA automatically resets).
Q 11 – Updating the HBA Restoring an HBA’s Firmware Parameters to the Factory Defaults 11.2 Restoring an HBA’s Firmware Parameters to the Factory Defaults Perform the following steps to reset the HBA’s firmware parameters to the factory defaults: 1. In the SANsurfer iSCSI HBA Manager main window HBA tree, select the HBA port. Click the HBA Options tab; click the Firmware tab. The HBA Options tabbed page (Firmware tab) displays (see figure 11-5). Figure 11-5.
11 – Updating the HBA Restoring an HBA’s Firmware Parameters to the Factory Defaults Q 2. From the Firmware tab Restore Factory Defaults option, click Restore. 3. The restore factory defaults message displays (see figure 11-6). Click OK to restore the defaults. Click Cancel to not restore the defaults. Figure 11-6. Restore Factory Defaults Message NOTE: The restored settings do not apply to currently configured targets.
Q 11 – Updating the HBA Upgrading an HBA with New Firmware 11.3 Upgrading an HBA with New Firmware If you are receiving a QLA4xxx HBA for the first time, the current version of firmware is already loaded. If you are upgrading a QLA4xxx HBA, follow the instructions in this section to load the latest firmware from the QLogic Web site. The SANsurfer iSCSI HBA Manager HBA Information tab displays the current firmware version (see section 9.2.1). To obtain the new firmware, follow these steps: 1.
11 – Updating the HBA Upgrading an HBA with New Firmware Q The HBA port information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state. See section 8.1 for details about the HBA port state and its correspondence with the HBA icons. ❑ ❑ ❑ ❑ Green background: good Yellow background: warning Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name.
Q 11 – Updating the HBA Updating an HBA’s ROM 4. The Download Firmware dialog box displays (see figure 11-10). Click Browse. Figure 11-10. Download Firmware Dialog Box 5. The Open dialog box displays (see figure 11-11). Select the firmware file that you downloaded previously, then click Open. Figure 11-11. Open Dialog Box (Firmware) 6. The file name displays in the Download Firmware dialog box. Click Save. 7. The Security Check dialog box displays. In the Enter Password box, type the password. Click OK.
Q 11 – Updating the HBA Updating the HBA Driver 11.5 Updating the HBA Driver NOTE: The SANsurfer iSCSI 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 Solaris SPARC. To obtain the new driver, follow these steps: 1. Obtain the new driver. Locate the iSCSI driver on the QLogic Web site (support.qlogic.com) and click Download. 2. The File Download dialog box displays. Click Save.
Q 11 – Updating the HBA Updating the HBA Driver The HBA port information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state. See section 8.1 for details about the HBA port state and its correspondence with the HBA icons. ❑ ❑ ❑ ❑ Green background: good Yellow background: warning Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name. HBA port iSCSI alias name.
Q 11 – Updating the HBA Updating the HBA Driver 4. The Open dialog box displays (see figure 11-14). Select the driver that you downloaded previously, then click Open. Figure 11-14. Open Dialog Box (Driver) 5. The Security Check dialog box displays. In the Enter Password box, type the password. Click OK. 6. The driver starts installing. The SANsurfer iSCSI HBA Manager main window status line flashes Current Operation: Updating driver until the update is complete.
Q 11 – Updating the HBA Updating an HBA’s BIOS from a File 11.6 Updating an HBA’s BIOS from a File NOTE: The SANsurfer iSCSI HBA Manager BIOS update feature is available only on Windows 2000/Windows Server 2003, and Red Hat/SuSE Linux systems. It is not available on Solaris SPARC systems. WARNING!! Changing HBA BIOS incorrectly can cause serious damage to your system. To obtain the new BIOS, follow these steps: 1. Obtain the new BIOS. Locate the iSCSI BIOS on the QLogic Web site (support.qlogic.
Q 11 – Updating the HBA Updating an HBA’s BIOS from a File The HBA port identifying information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state. See section 8.1 for details about the HBA port state and its correspondence with the HBA icons. ❑ ❑ ❑ ❑ Green background: good Yellow background: warning Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. ❑ HBA Alias Name.
Q 11 – Updating the HBA Updating an HBA’s BIOS from a File 4. The Open dialog box displays (see figure 11-17). Select the BIOS image file that you downloaded previously, then click Open. Figure 11-17. Open Dialog Box (BIOS) 5. The file name displays in the Download BIOS dialog box. Click Save. 6. The Security Check dialog box displays. In the Enter Password box, type the password. Click OK. 7.
11 – Updating the HBA Updating an HBA’s BIOS from a File Q Notes 11-18 IS0054602-00 A
Section 12 Troubleshooting Problems can occur when installing and using the SANsurfer iSCSI HBA Manager application. This section discusses: ■ Troubleshooting problems and solutions (see section 12.1) ■ Tracing SANsurfer iSCSI HBA Manager GUI and agent activity (debug), as directed by technical support (see section 12.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution Installation does not complete or terminates before completion Cause: There is insufficient disk space or not enough available memory. 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.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution SANsurfer iSCSI HBA Manager GUI cannot connect to the local host Cause: The iqlremote agent is not installed, the iqlremote agent is not running, or an incorrect system name was entered.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem SANsurfer iSCSI HBA Manager GUI connects to the same host more than once Cause and Solution Cause: Host IP address does not resolve to a host name. Solution: ■ If DNS is used, verify that DNS is working properly: ■ Verify that the host on which the GUI is running has a correct entry for the IP address and host name.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution Unable to find SANsurfer iSCSI HBA Manager GUI online help Cause: The path to the browser or Adobe Acrobat is not correctly specified or Adobe Acrobat is not installed. SANsurfer iSCSI HBA Manager GUI does not automatically refresh Cause: There is a disconnect with the iqlremote agent or network communication has stopped.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem SANsurfer iSCSI HBA Manager GUI loses the connection to a host Cause and Solution Cause: There is a disconnect with the iqlremote agent or network communication has stopped. Solution: ■ Verify that iqlremote is installed and running: ■ For Windows 2000/Windows Server 2003, open the Services window and verify that the QLogic Management Suite Java iQAgent service is running.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution SANsurfer iSCSI HBA Manager GUI loses the connection to an HBA Cause: There is a disconnect with the iqlremote agent or the operating system driver has lost communication with the HBA.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem SANsurfer iSCSI HBA Manager GUI crashes Cause and Solution Cause: Another application caused a conflict with SANsurfer iSCSI HBA Manager, insufficient memory, or insufficient disk space. Solution: ■ Verify that no other application is causing SANsurfer iSCSI HBA Manager to crash. ■ Verify that the disk and system memory requirements are met.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution Unable to run update BIOS Cause: This feature is not supported for all operating systems. Unable to change the security password Cause: The login requirements are not met. Solution: Verify that the appropriate account on the host system meets login name (user name) requirements. See section 6.5 for details.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Cause and Solution Deleted targets reappear after an HBA reset Cause: SendTargets (with no iSCSI name) are configured and an HBA reset has occurred. Solution: Delete the SendTargets (with no iSCSI name) that were configured during the initial discovery of the target. Cause: SLP is enabled.
Q 12 – Troubleshooting Troubleshooting Problems and Solutions Table 12-1. Troubleshooting Problems and Solutions (Continued) Problem Unable to use the Solaris hot swap feature on QLogic QLA4xxx HBAs Cause and Solution Cause: Cannot have iqlremote agent running when using the Solaris hot swap feature on the HBAs. Solution: Do the following. Note that management features are unavailable when iqlremote is not running. ■ Stop iqlremote.
12 – Troubleshooting Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) Q 12.2 Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) Additional information may be required to help troubleshoot SANsurfer iSCSI HBA Manager application problems. Once debug has been enabled following the steps in this section, attempt to reproduce the problem so that SANsurfer iSCSI HBA Manager GUI and agent activity can be captured.
Q 12 – Troubleshooting Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) The HBA port information displays: ❑ HBA. HBA instance number and HBA model ❑ State. The HBA port state. See section 8.1 for details about the HBA port state and its correspondence with the HBA icons. ❑ ❑ ❑ ❑ Green background: good Yellow background: warning Blue background: unknown Red background: bad ❑ HBA iSCSI Name. HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign.
Q 12 – Troubleshooting Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) Do one of the following: NOTE: When naming a crash file, include the HBA information, crash date, and crash time. ❑ Enter a name and location for the crash file or type a file name in the File Name box. Click Save. ❑ If you do not know the location, click Browse to display the Save dialog box (see figure 12-3). Select or type a file name in the File Name box. Click Save. Figure 12-3.
Q 12 – Troubleshooting Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) 12.2.2 Tracing SANsurfer iSCSI HBA Manager GUI Activity To trace SANsurfer iSCSI HBA Manager GUI activity, do the following: 1. Edit the local.properties file, which is located where SANsurfer is installed. Change the following two properties: node.trace.level=900 node.trace.output.setlevelonly=false See figure 12-4 for an example. Figure 12-4. local.properties File (Example) 2. Edit the SANsurfer.
12 – Troubleshooting Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) Q See figure 12-5 for an example. Figure 12-5. SANsurfer.
Q 12 – Troubleshooting Tracing SANsurfer iSCSI 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-6).
12 – Troubleshooting Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) Q 12.2.3 Exporting or Saving Agent Activity Logs This section discusses: ■ ■ The agent logs (see section 12.2.3.1) Exporting or saving the agent logs (see section 12.2.3.2) 12.2.3.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 iSCSI 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 one of the following to stop the currently running iqlremote agent: ❑ Type the following command and then press ENTER. /etc/rc3.d/S99iqlremote stop ❑ Type the following command and then press ENTER. pkill -TERM iqlremote ❑ Do the following. a.
12 – Troubleshooting Tracing SANsurfer iSCSI HBA Manager GUI and Agent Activity (Debug) Q Notes 12-20 IS0054602-00 A
Appendix A Frequently Asked Questions Table A-1 lists some frequently asked questions (FAQs) about the SANsurfer iSCSI HBA Manager application. For additional FAQs and other information, visit the QLogic support Web site support.qlogic.com. Table A-1. Frequently Asked Questions Question IS0054602-00 A Answer On what platforms does SANsurfer iSCSI HBA Manager run? The SANsurfer iSCSI HBA Manager GUI runs on any platform that supports the Java JVM 1.3 specification.
A – Frequently Asked Questions Q Notes A-2 IS0054602-00 A
Appendix B Glossary This section describes common hardware, software, and iSCSI terms that are used in the SANsurfer iSCSI HBA Manager application. IS0054602-00 A Adapter See HBA. BIOS A QLA4xxx HBA’s flash PROM contains the code that allows booting from the HBA at startup. Boot device The boot device is the hard disk that contains the operating system the BIOS uses to boot from when the computer is started.
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 IS0054602-00 A B – Glossary JBOD JBOD stands for just a bunch of disks. LUN LUN stands for logical unit number, the small integer handle that identifies a portion of disk storage. A LUN can consist of a single physical disk or many physical disks. A physical disk can be broken into multiple LUNs. NIC NIC stands for network interface controller. NVRAM NVRAM stands for nonvolatile random access memory. NVRAM configuration settings are stored in NVRAM.
Q B – Glossary B-4 SAN SAN stands for storage area network, which consists of multiple storage units and servers connected by networking topology. SCSI SCSI stands for small computer system interface. The original SCSI specification was a hardware bus specification and a packet-oriented protocol specification for communicating on that bus. SCSI over Fibre Channel uses the packet-oriented protocol to communicate with storage devices on the Fibre Channel.
Appendix C 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 iSCSI 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 iSCSI HBA Manager main window toolbar.
C – Contacting QLogic Q Notes C-2 IS0054602-00 A
