Fibre channel npiv storage networking for windows server 2008 r2 hyper-v and system center vmm2008 r2 usage scenarios and best practices guide (78 pages)
QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification.
Page 3
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters Removed the following sections that were included — in rev. A of the user’s guide. Information from these sections is now in the SANsurfer iSCSI HBA Man- ager help system: 7.
Page 4
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters Notes Page iv IS0054602-00 B...
HBA Manager, a component of the QLogic SANsurfer tool. SANsurfer iSCSI HBA Manager is a comprehensive tool for configuration and management of QLogic SANsurfer iSCSI host bus adapters (HBAs) used in storage area networks (SANs). NOTE: Throughout this guide, HBA and adapter are used interchangeably, as are the terms target and device.
Web sites are shown in underlined blue. For example: Table 9-2 lists problems related to the SANsurfer iSCSI HBA Manager user interface and remote agent. “Pinging Targets” on page 6-2. For more information, visit www.qlogic.com. IS0054602-00 B...
SANsurfer iSCSI HBA CLI User’s Guide provides interactive menu Rev. E and non-interactive mode options for the command line interface. License Agreements For a complete listing of all license agreements affecting this product, refer to the QLogic Software End User License Agreement. IS0054602-00 B...
Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. For the latest firmware and software updates, visit the QLogic support Web site listed in Contact Information.
General Overview QLogic’s SANsurfer iSCSI HBA Manager is a user-based interface tool that configures and manages both QLogic iSCSI host bus adapters and their attached devices within a storage area network (SAN) environment. In addition: ®...
SANsurfer iSCSI HBA Manager allows you to configure local and remote systems. With SANsurfer iSCSI HBA Manager, you can: Configure QLogic iSCSI HBAs, HBA ports, and attached iSCSI targets using a configuration wizard. Configure HBA port boot settings (BIOS and FCode) and boot targets, including acquiring boot targets via DHCP.
Retrieve HBA diagnostics information. HBA State and Target Session Connection State Monitoring SANsurfer iSCSI HBA Manager monitors connected QLogic iSCSI HBAs and their targets and informs you of their state. For HBAs, the state color indicates bad (red), unknown (blue), warning (yellow), or good (green).
Page 18
You do not have ACB (Alternate Control Block) support with the proper hardware configuration, drivers, and firmware. You can access these features if you have the correct hardware configuration and download the latest drivers and firmware from the QLogic Web site. IS0054602-00 B...
Installation Checklist SANsurfer iSCSI HBA Manager is a collection of device drivers and management software for controlling, configuring, and managing devices in a SAN environment that uses QLogic iSCSI HBAs. Use the following Installation Checklist to help you install all hardware and software properly and in the correct order. To see a list of the required hardware and software, refer to the “System Requirements”...
The most current device driver versions can be found at the QLogic Web site (www.qlogic.com). Connections to iSCSI targets must be configured with SANsurfer iSCSI HBA Manager or QLogic Fast!UTIL in order for them to be visible to the operating system. IS0054602-00 B...
Manager. SANsurfer iSCSI HBA Manager runs as both a tool with standalone (non-agent mode) access to local system QLogic iSCSI HBAs and as a client/server tool. The client tool runs on a hardware platform that supports Java™ and agents running on each system that has QLogic HBAs.
For a complete list of devices, see the QLogic SAN Interoperability Guide, which can be downloaded from the QLogic Web site (you will be asked to provide your e-mail address): http://connect.qlogic.com/interopguide/Interoperability.asp 64 MB of physical RAM are required to run SANsurfer iSCSI HBA Manager;...
Solaris SPARC 9, 10 Solaris x86 9, 10 (IA32) Solaris x86 9, 10 (x64) QLogic QLA4xxx drivers (such as QLA4010C drivers), as appropriate for your HBA. Common desktop environment (CDE) to run SANsurfer iSCSI HBA Manager user interface on Solaris systems.
Use the Java runtime environment that is packaged with SANsurfer iSCSI HBA Manager. Supported QLogic HBAs The QLogic iSCSI HBAs are collectively referred to as the QLA4xxx HBA, unless otherwise noted. For a detailed list of supported QLogic HBAs, see the SANsurfer HBA Support Matrix (Fibre Channel &...
“Uninstalling SANsurfer” on page 4-24 Initial Installation You can install the SANsurfer tool (which includes SANsurfer iSCSI HBA Manager) using the files from the QLogic Web site or from the SANsurfer CD-ROM. The following information applies: Install the same version of SANsurfer on all systems in the network.
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation This section on initial installation includes the following information: “Installation Configurations” on page 4-2 “Installation Instructions” on page 4-3 “Installation Instructions Using CLI” on page 4-15 Installation Configurations SANsurfer iSCSI HBA Manager supports both standalone and networked configurations, as shown in Table 4-1.
On the File Download Security dialog box, click Save to save the SANsurfer iSCSI HBA Manager installer to a location on your hard drive. To download the Installer from the QLogic Web site: Open the QLogic home page (http://www.qlogic.com). Click the Downloads tab to open the Driver Downloads / Documentation page.
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation Go to the table under QLogic Models, as shown in Figure 4-1. Figure 4-1 QLogic Driver Downloads / Documentation Page Choose your download options as follows: In first column, select iSCSI HBAs.
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation To ensure that the SANsurfer installer file is executable and to start the installation, type the following, and then press ENTER. sh ./<installation_filename>.bin Step 3: Follow the Installation Wizard To use the installation wizard: When the installation wizard begins, the Introduction dialog box (Figure 4-2)
Read the important information, and then click Next. This same information is provided in the readme.txt file, that will be available following installation in the following locations: On supported Windows systems: Program Files\QLogic Corporation\SANsurfer On supported Linux and Solaris systems: opt/QLogic_Corporation/SANsurfer IS0054602-00 B...
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation The Choose Product Features dialog box (Figure 4-4) opens. Figure 4-4 Installation Wizard: Choose Product Features NOTE: Except for the agents that are installed, the feature options are the same for supported Windows, Linux, and Solaris systems. Windows agents are installed on a supported Windows system.
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation Select iSCSI GUI to install the SANsurfer iSCSI HBA Manager user interface only. The manager agent is not installed. Select iSCSI Windows Agent to install only the SANsurfer iSCSI HBA Manager agent for a supported Windows system. Select Custom to choose which components to install.
To accept the destination location shown in the dialog box (recommended), click Next. The default location for a Windows system is: C:\Program Files\QLogic Corporation\SANsurfer The default location for a Linux or Solaris system is: /opt/QLogic_Corporation/SANsurfer To select a different location: Click Choose and browse to the location of your choice.
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation If a version of SANsurfer iSCSI HBA Manager already exists on the system, the Previous SANsurfer Install Detected dialog box (Figure 4-7) opens. Figure 4-7 Installation Wizard: Previous SANsurfer Install Detected Because the new version is not compatible with the older version, the installation procedure prompts you to uninstall the old version.
Available shortcuts include: The SANsurfer icon on the desktop (if you select it in Step QLogic Management Suite (SANsurfer and SANsurfer Uninstaller), which is accessible when you click the Start button and point to Programs. To select the shortcut profile, click one of the following, and then click Next: All Users Profile if you want the tool shortcuts available to all users.
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation If you are installing the SANsurfer iSCSI HBA Manager user interface on a Windows system, the Create Desktop Icon Selection dialog box (Figure 4-9) opens. Figure 4-9 Installation Wizard: Create Desktop Icon Selection If you want the SANsurfer icon to appear on the desktop, select the Create Desktop Icon check box (default), and then click Next.
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation The Pre-Installation Summary dialog box (Figure 4-10) opens. Figure 4-10 Installation Wizard: Pre-Installation Summary The pre-installation summary shows you all the choices you made in previous steps. Review the information. If you want to go back and change any settings, click Previous.
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation The Installing SANsurfer dialog box (Figure 4-11) opens. Figure 4-11 Installation Wizard: Installing SANsurfer Various windows inform you that the installation is progressing. 4-14 IS0054602-00 B...
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation After the installation is complete, the Install Complete dialog box (Figure 4-12) opens. Figure 4-12 Installation Wizard: Install Complete To close the installation wizard, click Done. To customize SANsurfer iSCSI HBA Manager and set your security parameters, see 5 Getting Started.
Page 40
4 – Installing SANsurfer iSCSI HBA Manager Initial Installation NOTES: If you misspell the install set ID or if the installer program cannot find the install set, then the installer program installs the default install set, which is the user interface plus the OS agent. To change the destination folder, add the -D parameter to the command lines as follows: -DUSER_INSTALL_DIR="d:\Apps\SANsurfer"...
“Updating SANsurfer by Package Update” on page 4-21. Updating SANsurfer by Web Update Obtain SANsurfer updates from the QLogic Web site or from service personnel. CAUTION! To avoid locked files during the update process, you must exit SANsurfer. To check for updates: On the SANsurfer iSCSI HBA Manager main window, open the Help menu, and then click Web Update.
Network Does Not Use Proxy Settings Follow these steps to update SANsurfer from the QLogic Web site when your network does not use proxy settings to access the Internet. To update SANsurfer (network does not use proxy settings):...
4 – Installing SANsurfer iSCSI HBA Manager Web- and CD-based Installation Updates The Server Proxy Settings dialog box (Figure 4-14) opens. Figure 4-14 Update SANsurfer: Server Proxy Settings Dialog Box If you want the HTTP proxy setting to be detected automatically, leave the dialog box as is, and then click OK to continue.
4 – Installing SANsurfer iSCSI HBA Manager Web- and CD-based Installation Updates When your computer accesses the Internet, the Update dialog box (Figure 4-15) appears. Figure 4-15 Update SANsurfer: Update Dialog Box The available update information includes: Current Updates column lists product updates available for the current tool version.
4 – Installing SANsurfer iSCSI HBA Manager Web- and CD-based Installation Updates When you finish selecting the update packages and are ready to start the download and installation process, click Update. Follow the instructions to install the selected package. Or, to discontinue the update process and stop the installation, click Cancel.
4 – Installing SANsurfer iSCSI HBA Manager Web- and CD-based Installation Updates The Open dialog box (Figure 4-17) appears. Figure 4-17 Update SANsurfer: Open Dialog Box Select the SANsurfer iSCSI HBA Manager patch update file web_supported_update_iscsi_hba.txt, which can be located on a local file system or on a CD, DVD, or portable storage device.
4 – Installing SANsurfer iSCSI HBA Manager Web- and CD-based Installation Updates After you open the patch update file, the Update dialog box (Figure 4-18) opens, showing available update information. Figure 4-18 Update SANsurfer: Update Dialog Box The available update information includes: Current Updates column lists product updates available for the current tool version.
To uninstall SANsurfer iSCSI HBA Manager: To start the SANsurfer uninstaller from a Windows system, choose one of the following methods: On the Windows Start menu, point to Programs, point to QLogic Management Suite, and then click SANsurfer Uninstaller. Use the Add/Remove Programs utility: On the Windows Start menu, point to Settings, and then click Control Panel.
4 – Installing SANsurfer iSCSI HBA Manager Uninstalling SANsurfer Figure 4-19 shows an example of the Add/Remove Programs utility for Windows. Figure 4-19 Uninstall SANsurfer: Add/Remove Programs Dialog Box In the left column, click Change or Remove Programs (default). Under Currently Installed Programs, select SANsurfer x.x. Click Change/Remove.
4 – Installing SANsurfer iSCSI HBA Manager Uninstalling SANsurfer The Uninstall Options dialog box (Figure 4-21) opens. Figure 4-21 Uninstall SANsurfer: Uninstall Options Choose whether to uninstall the entire SANsurfer tool or specific features, and then click Next: Click Complete Uninstall to remove all features and components of the SANsurfer tool that were installed by InstallAnywhere.
4 – Installing SANsurfer iSCSI HBA Manager Uninstalling SANsurfer The Choose Product Features dialog box (Figure 4-22) opens. Figure 4-22 Uninstall SANsurfer: Choose Product Features The dialog box differs, depending on whether you are using SANsurfer iSCSI HBA Manager on a Windows, Linux, or Solaris system. Clear the check boxes for features that you want to uninstall.
4 – Installing SANsurfer iSCSI HBA Manager Uninstalling SANsurfer Click Uninstall. The Uninstall SANsurfer dialog box (Figure 4-23) lists the components that are being uninstalled. Figure 4-23 Uninstall SANsurfer: Feature Removal In-progress A message box asks you to wait the while the uninstaller removes the components.
Some files and directories remain after uninstalling SANsurfer. These components must be deleted manually from the computer's hard disk where SANsurfer was installed. The default locations are: For Windows: Program Files\QLogic Corporation\SANsurfer For Linux and Solaris: /opt/QLogic_Corporation/SANsurfer Reboot the system.
Getting Started This section includes the procedures for starting and exiting the SANsurfer iSCSI HBA Manager user interface, and customizing the tool options and policies. It provides information on: “Starting SANsurfer iSCSI HBA Manager” on page 5-1 “SANsurfer iSCSI HBA Manager Main Window” on page 5-3 “Exiting SANsurfer iSCSI HBA Manager”...
5 – Getting Started Starting SANsurfer iSCSI HBA Manager Click the Start button, point to Programs, point to QLogic Management Suite, and then click SANsurfer. Click the Start button, click Run, and then do one of the following: Type in the SANsurfer program file name (SANsurfer.EXE), including all the paths, and then click OK.
5 – Getting Started SANsurfer iSCSI HBA Manager Main Window SANsurfer iSCSI HBA Manager Main Window The HBA Manager supports the following tools: The iSCSI HBA tab opens SANsurfer iSCSI HBA Manager. The FC HBA tab opens SANsurfer FC (Fibre Channel) HBA Manager. The Switch tab opens SANsurfer Switch Manager.
5 – Getting Started SANsurfer iSCSI HBA Manager Main Window Tool Tab Title Bar Menu Bar Toolbar Tabbed Pages Content Pane HBA Tree System Tree Pane Status Bar Figure 5-2 SANsurfer iSCSI HBA Manager Main Window The window contains the following components: The title bar identifies the currently active tool selected by the tool tab.
5 – Getting Started SANsurfer iSCSI HBA Manager Main Window The HBA tree in the system tree pane shows the presence and status of hosts, HBAs, and devices. For details, see “HBA Tree” on page 5-5. Tabbed pages in the content pane contain settings for similar kinds of operations.
Page 60
For information about the HBA port state referenced in the dialog boxes and its correspondence with the HBA icons, see the help topic, Monitoring the HBA Port State. Examples: Port 0: iqn.2000-04.com.qlogic:qla4010.fs10352a00378 AdapterPort Svr_1_HBA_5 The HBA Port icons are: Good Virtual...
For information about the target state referenced in the dialog boxes and its correspondence with the device icons, see the help topic, Monitoring the Target State. Examples: Device (ipn.qlogic.3.0) Device (target_3_0) The device icons are: Device good session connection Device unknown/no active session connection...
5 – Getting Started Getting Help Viewing the Help System The SANsurfer iSCSI HBA Manager help system provides quick access to information about performing tasks and completing dialog boxes. To view the help system from the SANsurfer iSCSI HBA Manager main window, open the Help menu and click Browse Contents, or press the F1 key.
5 – Getting Started Getting Help Click the Index button to show an alphabetic listing of keywords associated with the help topics. Scroll through the listing to find keywords, and then choose from one or more topics associated with that keyword. Click the Search button to quickly find a topic containing one or more words.
To close the Browser Location dialog box without making changes, click Cancel. Viewing SANsurfer iSCSI HBA Manager Information The About box shows the product version number and QLogic copyright information. To view information about SANsurfer iSCSI HBA Manager: On the SANsurfer iSCSI HBA Manager main window Help menu, click About.
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager This window provides the following information: High Availability Edition version number. Copyright information. To close the About window and return to the SANsurfer iSCSI HBA Manager main window, click OK. Setting Up SANsurfer iSCSI HBA Manager Some of the basic set up you may want to perform for SANsurfer iSCSI HBA Manager includes the following:...
Page 66
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager Windows 2000/Windows Server 2003. The login name (username) must be attached to an account that the agent is running on and that must be in the administrator group. Red Hat/SLES Linux and Solaris SPARC. The login name (user name) must be attached to an account that the agent is running on and that must be in the adm or root group.
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager The Security page (Figure 5-6) opens, and the host name appears at the top of the page. Figure 5-6 Security Page (Host) Under Host Access are the system login and password that you use to access the machine.
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager Specifying Whether iSCSI Names or iSCSI Alias Names Appear in the HBA Tree You can specify whether the iSCSI name or the iSCSI alias name appears in the HBA tree. After you specify whether the iSCSI name or the iSCSI alias name is shown, your selection becomes the default.
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager The Application Options dialog box (Figure 5-8) opens. Figure 5-8 Application Options: Tree View Naming Preference Under Tree Viewing Naming Preference, select one of the following Tree Naming options: Click Alias if you want the HBA port and target iSCSI alias names to show in the tree.
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager Set the HBA polling and host polling intervals to retrieve host status alarms (see “Specifying the Polling Intervals to Retrieve Host Status Alarms” on page 5-16). Specify whether host status alarms and target status alarms refresh the configuration (see “Specifying Whether the Configuration Refreshes When Host and Target Status Alarms Occur”...
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager If something has changed and the SANsurfer iSCSI HBA Manager update behavior configuration is set to update when the poll or host status alarms occur (see “Specifying Whether the Configuration Refreshes When Host and Target Status Alarms Occur”...
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager NOTES: You cannot disable HBA polling. The faster the polling rate, the more quickly the SANsurfer iSCSI HBA Manager user interface receives indications from the connected HBAs. However, faster polling rates consume more of your system’s CPU and network resources and slow the system.
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager Specifying Whether the Configuration Refreshes When Host and Target Status Alarms Occur You can specify whether or not the SANsurfer iSCSI HBA Manager user interface configuration refreshes each time your system receives a host status alarm or target status alarm.
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager When you clear the Enable All Updates from Host Alarms check box, the Enable Updates from Target Status Alarms check box is unavailable. To save your changes to the update behavior, click OK. To close the Application Options dialog box without saving any changes, click Cancel.
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager When the host configuration changes, the following confirmation message (Figure 5-13) appears. Figure 5-13 iSCSI Configuration Change Confirmation To refresh the configuration, click Yes. To continue to show the current configuration, click No. To prevent the iSCSI configuration change message from appearing when a host configuration has changed, clear the Enable Prompt to Accept Host Refresh check box.
Page 76
5 – Getting Started Setting Up SANsurfer iSCSI HBA Manager Notes 5-22 IS0054602-00 B...
QLA406x cards. If you are using a QLE406x iSCSI HBA and download the standard drivers and latest firmware from the QLogic Web site, you can access the IPv6 features. IS0054602-00 B...
: Bad, indicating that the HBA port is not available. HBA iSCSI Name HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign. iSCSI Port Alias HBA port iSCSI alias name. Symbolic name you assign to Name the HBA port for identification purposes.
6 – Performing Diagnostics Pinging Targets Pinging Targets Pinging a target is an attempt by the HBA port to contact the targeted device. If the ping is successful, it verifies that there is connectivity between the HBA port and the target. Ping Page To access the Ping page: On the SANsurfer iSCSI HBA Manager main window HBA tree, select the...
6 – Performing Diagnostics Pinging Targets The Ping page shows the following ping diagnostic information: IPv4 Address Select to enter IPv4 address of the target. IPv6 Address Select to enter IPv6 address of the target. IPv6 source Port address from which the ping originates. This address address could be the Auto Address, meaning the firmware determined the address of the HBA.
6 – Performing Diagnostics Pinging Targets When the test is complete, the Ping Status dialog box (Figure 6-3) informs you of the results. Figure 6-3 Ping Status Dialog Box To close the dialog box, click OK. To ping an IPv6 address: On the Ping page (Figure 6-2 on page 6-3), click IPv6 Address, and then...
6 – Performing Diagnostics Viewing Logs Viewing Logs SANsurfer iSCSI HBA Manager provides several types of information logs. The following sections tell you how to access each log: “Viewing the ARP Log” on page 6-6 “Viewing the Connection Error Log” on page 6-8 “Viewing the IPv6 Destination Cache Log”...
6 – Performing Diagnostics Viewing Logs The Logs page opens within the Diagnostics page (Figure 6-4). Figure 6-4 Logs Page (Diagnostics) On the Logs page, click Display ARP Table. The ARP Log opens (Figure 6-5). Figure 6-5 ARP Log For the HBA port that you selected, the ARP log shows the HBA port connections with remote network hardware: IS0054602-00 B...
6 – Performing Diagnostics Viewing Logs IP Address is the IP address of the hardware on the remote network. MAC Address is the MAC address of the hardware on the remote network. If you want to refresh the log information immediately, click Refresh. To exit the log, click Close.
Page 85
If you have ACB support, the date-time stamp is in 12 hour format. If you do not have ACB support, the date-time format is in seconds since the last HBA reset. To activate ACB support, download the standard drivers and latest firmware from the QLogic Web site. For more detailed information, see the...
6 – Performing Diagnostics Viewing Logs Viewing the IPv6 Destination Cache Log The IPv6 destination cache contains the IP address, next hop IP address, and path MTU information for both local and remote destinations. For multicast and on-link unicast destinations, the next hop IP address always matches the destination IP address.
6 – Performing Diagnostics Viewing Logs For the HBA port that you selected, the destination cache log shows the following information: Last Update Time The date-time stamp of the last destination cache entry. The date-time stamp is in 12 hour format. Destination IP The destination IP address of an IPv6 iSCSI target.
6 – Performing Diagnostics Viewing Logs The IPv6 Neighbor Cache log opens (Figure 6-7). Figure 6-8 Neighbor Cache Log NOTE: If text in any column is truncated, move the cursor over it to reveal the entire text in a tool tip next to the cursor. For the HBA port that you selected, the neighbor cache log shows the following information: Last Update Time The date-time stamp of the last neighbor cache entry.
6 – Performing Diagnostics Viewing Logs If you want to refresh the log information immediately, click Refresh. To exit the log, click Close. Viewing the IPv6 Router List Log The IPv6 Router List log includes both the active default router (shown in the IPv6 section of the Port Network page) and a short list of other routers that advertised themselves as being capable of acting as a default router.
6 – Performing Diagnostics Viewing Logs Last Update Time The date-time stamp of the last router list entry. The date-time stamp is in 12 hour format. Router IP Address The IP address of the router. Router Lifetime The length of time, in minutes and seconds, that the router can be used as the default router for this entry.
6 – Performing Diagnostics Viewing Logs The IPv6 Prefix List dialog box opens (Figure 6-9). Figure 6-10 IPv6 Prefix List Log For the HBA port that you selected, the prefix list log shows the following information. Last Update Time The date-time stamp of the last router list entry. The date-time stamp is in 12 hour format.
6 – Performing Diagnostics Setting Diagnostic Test Parameters Setting Diagnostic Test Parameters SANsurfer iSCSI HBA Manager offers two diagnostic tests: loopback and read/write buffer. You can access the testing functions on the Advanced page of the Diagnostics page for an HBA port. To set the parameters and run these tests, see the following sections: “Running a Loopback Test”...
6 – Performing Diagnostics Setting Diagnostic Test Parameters The Advanced page opens within the Diagnostics page (Figure 6-11). Figure 6-11 Advanced Page (Diagnostics): Loopback Test The Advanced page shows the test configuration options on the top portion and the test results on the bottom portion. Under Test Configuration, click either Internal Loopback Test or External Loopback Test.
6 – Performing Diagnostics Setting Diagnostic Test Parameters In the Num Of Tests (1-10000) box, enter the number of tests you want to run. The testing session stops when the tests are complete. The valid range is between 1 and 10,000. In the Test Increment (1-10000) box, enter the number of iterations you want to run before a test is complete.
6 – Performing Diagnostics Setting Diagnostic Test Parameters On the Diagnostics page, click the Advanced tab. The Advanced page opens within the Diagnostics page (Figure 6-12). Figure 6-12 Advanced Page (Diagnostics): Read/Write Buffer Test The Advanced page shows the test configuration options on the top portion and the test results on the bottom portion.
Page 96
6 – Performing Diagnostics Setting Diagnostic Test Parameters In the Test Increment (1-10000) box, enter the number of iterations you want to run before a test is complete. The valid range is between 1 and 10,000, and must be less than or equal to the value in the Num of Tests box.
Agent Activity” on page 7-14, or use the new, simple option in the user interface to trace activity in the user interface, agent, non-agent JNI (JNI Corporation’s JNIC-1560 HBA), and iSDMAPI (QLogic’s proprietary application programming interface to manage QLA4xxx adapters). To trace activity: On the Settings menu, click Diagnostics Options.
Page 98
6 – Performing Diagnostics Tracing User and Agent Activity To allow user interface diagnostic logging information to be saved to a file, follow these steps: Under SANsurfer GUI Diagnostic Preferences, select the Enable GUI diagnostic logging to a file check box. For Logging Level, select one of the following levels of logging: None Error Level...
Page 99
6 – Performing Diagnostics Tracing User and Agent Activity Select the Log data only at specified level check box to log only at the level selected under Logging Level. To log data at multiple levels, clear this check box. In the Log File Size box, enter the maximum size in KB of the logging file.
Page 100
6 – Performing Diagnostics Tracing User and Agent Activity Notes 6-24 IS0054602-00 B...
SANsurfer iSCSI Solaris Agent, or SANsurfer iSCSI NetWare 5/6.x Agent with which the SANsurfer iSCSI HBA Manager user interface (client) connects to manage QLogic QLA2xxx iSCSI HBAs. Troubleshooting Tools The following sections explain how to use the Windows event log and SANsurfer iSCSI HBA Manager to solve hardware problems.
7 – Troubleshooting Troubleshooting Problems and Solutions SANsurfer iSCSI HBA Manager Tools SANsurfer iSCSI HBA Manager provides the following diagnostic tools for managing iSCSI HBAs: Pinging a Target. Pinging verifies the connectivity between an HBA port and a device port. Viewing the ARP Log.
7 – Troubleshooting Troubleshooting Problems and Solutions Installation Issues Table 7-1 lists problems that can occur when installing SANsurfer iSCSI HBA Manager, and provides possible causes and solutions. Table 7-1. Troubleshooting: Installation Issues Problem Cause and Solution Installation does not run. Cause: You are not using the correct installation program or the down- loaded installation file is corrupted.
Solution: Verify that the desktop shortcut points to the shortcut (SANsurfer icon). SANsurfer.exe file. For Windows, this program is installed by default in the following folder: C:\Program Files\QLogic Corporation\SANsurfer SANsurfer iSCSI HBA Man- Cause: There is insufficient memory. ager user interface starts, and Solution: For physical RAM requirements, see “Hardware Require-...
Page 105
7 – Troubleshooting Troubleshooting Problems and Solutions Table 7-2. Troubleshooting: User Interface and Remote Agent Issues (Continued) Problem Cause and Solution SANsurfer iSCSI HBA Man- Cause: The iqlremote agent is not installed on the remote system or ager user interface cannot the network protocol is not properly configured.
Page 106
Solution: Install a QLogic QLA4xxx HBA. find or show any HBAs. Cause: The current QLogic iSCSI driver is out of date and does not support the installed newer-generation iSCSI card. This is common with drivers that are shipped with the operating system.
Page 107
7 – Troubleshooting Troubleshooting Problems and Solutions Table 7-2. Troubleshooting: User Interface and Remote Agent Issues (Continued) Problem Cause and Solution SANsurfer iSCSI HBA Man- Cause: There is a disconnect with the iqlremote agent or network com- ager user interface does not munication has stopped.
Page 108
7 – Troubleshooting Troubleshooting Problems and Solutions Table 7-2. Troubleshooting: User Interface and Remote Agent Issues (Continued) Problem Cause and Solution SANsurfer iSCSI HBA Man- Cause: There is a disconnect with the iqlremote agent or the operating ager user interface loses the system driver has lost communication with the HBA.
7 – Troubleshooting Troubleshooting Problems and Solutions Functional Issues Table 7-3 lists functional problems that may occur with using SANsurfer iSCSI HBA Manager, and provides possible causes and solutions. Table 7-3. Troubleshooting: Functional Issues Problem Cause and Solution Unable to get host Informa- Cause: The iqlremote agent is not running or installed.
Page 110
7 – Troubleshooting Troubleshooting Problems and Solutions Table 7-3. Troubleshooting: Functional Issues (Continued) Problem Cause and Solution Unable to change the security Cause: The login requirements are not met. password. Solution: Verify that the appropriate account on the host system meets login name (user name) requirements.
Page 111
7 – Troubleshooting Troubleshooting Problems and Solutions Table 7-3. Troubleshooting: Functional Issues (Continued) Problem Cause and Solution Targets do not show the new Cause: Targets keep the firmware values with which they were origi- firmware values (factory nally configured. defaults, updates, nor new Solution: If you want a target to have the new firmware values, do the firmware).
1. Stop iqlremote as follows. For supported Windows systems, open the Services window and stop the QLogic Management Suite Java iQAgent service. For Red Hat/SLES Linux and Solaris SPARC, type one of the fol- lowing commands and then press ENTER: /etc/rc3.d/S99iqlremote stop...
In the left pane of the Computer Management window, click Device Manager. In the right pane, click SCSI and RAID controllers. Right-click a QLogic FC Adapter (which is a QLogic FC HBA port). On the shortcut menu, click Properties. On the QLogic Fibre Channel Adapter Properties, click the Driver tab.
7 – Troubleshooting Using Debug to Trace User Interface and Agent Activity If the service is already started, stop, and then restart the service. Figure 7-1 Windows: Services To verify that iqlremote is installed and running on Red Hat/SUSE Linux: Type the following command, and then press ENTER: # ps -ef | grep iqlremote If entries appear, iqlremote is loaded.
7 – Troubleshooting Using Debug to Trace User Interface and Agent Activity Additionally, saving the host configuration file makes it easier to diagnose any problems you may have. For more information, see the help topic, Saving the Host Configuration to a File.
7 – Troubleshooting Using Debug to Trace User Interface and Agent Activity Figure 7-2 shows an example of the local.properties file edits. Figure 7-2 local.properties in Notepad Tip: Increasing the Screen Buffer Size Height When using a Windows system, it is convenient to change the height of the screen buffer. To increase screen buffer height: Click the Start button, point to Programs, point to Accessories, and then click Command Prompt.
7 – Troubleshooting Using Debug to Trace User Interface and Agent Activity The Command Prompt window opens (Figure 7-3). Figure 7-3 Command Prompt Window Click the icon on the left side of the title bar, and then on the shortcut menu, click Properties.
7 – Troubleshooting Using Debug to Trace User Interface and Agent Activity The “Command Prompt“ Properties dialog box opens (Figure 7-4). Figure 7-4 “Command Prompt” Properties Click the Layout tab. On the Layout page under Screen Buffer Size, type 9999 in the Height box, and then click OK.
Open the iSCSIAgent.properties file, located in the SANsurfer installation directory. Change the property iscsi.agent.logging.enabled to true. Save the iSCSIAgent.properties file. Open a command shell (DOS) window. Change to the install directory. For example: cd C:\Program Files\QLogic Corporation\SANsurfer IS0054602-00 B 7-19...
7 – Troubleshooting Using Debug to Trace User Interface and Agent Activity Shutdown the agent by entering the following command: iqlremote –u Restart the agent by first entering the following commands in succession: iqlremote –i iqlremote –s To view and save the full agent output, use a tool such as DebugView, available at the following URL: www.microsoft.com/technet/sysinternals/ Tracing User Interface Activity for UNIX OS...
7 – Troubleshooting Using Debug to Trace User Interface and Agent Activity Figure 7-2 shows an example of the local.properties file edits. Figure 7-7 local.properties in Notepad To set the debug environment variable: Open a UNIX command prompt. Set the environment variable, LAX_DEBUG, to true by entering the following command: LAX_DEBUG=true To capture the output of user interface logging to a file, start SANsurfer...
7 – Troubleshooting Retrieving Records Saving Agent Activity Logs for UNIX OS For UNIX operating systems, save the current agent log by following this procedure at the command prompt. To save agent activity logs: Activate the iSCSI agent logging facility as follows: Open the iSCSIAgent.properties file, located in the /etc directory.
However, if you are using HBAs other than QLA4010 and download the standard drivers and latest firmware from the QLogic Web site, you can access the Retrieve Core Dump Record feature. To save the log information to a file: On the SANsurfer iSCSI HBA Manager main window HBA tree, select an HBA.
7 – Troubleshooting Retrieving Records HBA port-identifying information on the top of the HBA Options page includes the following: HBA Model HBA instance number and HBA model. State The HBA port state. For details about the HBA port state and its correspondence with the HBA icons, see the help topic, Monitoring the HBA Port State.
However, if you are using HBAs other than QLA4010 and download the standard drivers and latest firmware from the QLogic Web site, you can access the Retrieve Flash NVRAM Record feature. To save the log information to a file: On the SANsurfer iSCSI HBA Manager main window HBA tree, select an HBA.
7 – Troubleshooting Retrieving Records HBA port-identifying information on the top of the HBA Options page includes the following: HBA Model HBA instance number and HBA model. State The HBA port state. For details about the HBA port state and its correspondence with the HBA icons, see the help topic, Monitoring the HBA Port State.
7 – Troubleshooting Retrieving Records NOTE: When naming a Flash NVRAM file, it is helpful to include the HBA information, crash date, and crash time. If you do not know the location, click Browse. The Save dialog box opens. Select or type a file name in the File Name box, and then click Save.
7 – Troubleshooting Retrieving Records The HBA Utilities page (Figure 7-10) opens within the HBA Options page. Figure 7-12 HBA Utilities Page (HBA Options) for QLA4010x HBA port-identifying information on the top of the HBA Options page includes the following: HBA Model HBA instance number and HBA model.
7 – Troubleshooting Retrieving Records Serial Number HBA serial number. HBA Alias Name HBA port iSCSI alias name. Symbolic name you assign to the HBA port for identification purposes. On the HBA Utilities page, click Retrieve Crash Record. The Save Crash Record dialog box (Figure 7-13) opens.
Page 133
Frequently Asked Questions Table A-1 lists some frequently asked questions (FAQs) about SANsurfer iSCSI HBA Manager. For additional FAQs and other information, visit the QLogic support Web site, support.qlogic.com. Table A-1. Frequently Asked Questions Question Answer On what platforms does SANsurfer iSCSI...
Page 134
A – Frequently Asked Questions Table A-1. Frequently Asked Questions (Continued) Question Answer Can SANsurfer iSCSI HBA Manager be No, SANsurfer iSCSI HBA Manager currently does not run run as a Java applet? as a Java applet. Does SANsurfer iSCSI HBA Manager sup- No, SANsurfer iSCSI HBA Manager currently supports only port SNMP? the RPC communication layer between the user interface...
Page 135
See HBA. Boot code for QLogic FC HBAs is required if the computer system is booting from a Alternate Control Block is a subset of the storage device (boot device) attached to InitFW block of firmware parameters in the QLogic HBA.
Page 136
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters device In NetWare, the required drivers include: A computer subsystem, such an HBA Host Adapter Module (HAM) is the card, which mediates data in a computer driver component associated with the network.
Page 137
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters fabric Consists of cross-connected devices Host bus adapter. An HBA is the board and switches. that interfaces between the host system and device. HBA is synonymous with host fabric switch adapter, adapter, and adapter board.
Page 138
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters IOCB loopback I/O control block. An IOCB is a command A diagnostic tool where data is transmitted structure in QLogic ISP architecture. and received by the QLA2xxx HBA.
Page 139
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters the request from another initiator or on a different port. Network interface controller. A computer circuit board or card that is installed in a path MTU computer so that it can be connected to a Path maximum transmission unit.
Page 140
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters SPIFFI Specification for platform-independent failover and failback integration. It is a cooperative effort that defines a non vendor-specific failover mechanism. storage area network See SAN. sysfs A virtual file system provided by the 2.6...
Page 141
Index alarms host status 5-15 About box 5-10 refreshing configuration upon occurrence 5-19 definition of Glossary-1 retrieving for host 5-16 support for 2-4, 6-9, 7-23, 7-26 alias name, iSCSI HBA port access password, requiring 5-11 Alternate Control Block, See ACB activity logs, agent Application Options dialog box saving on UNIX...
Page 142
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters CD-ROM, downloading installer from debug, tracing user interface and agent activity 7-14 checking for SANsurfer updates 4-17 DebugView, using to view agent output 7-20 checklist for installation...
Page 143
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters e-mail, contacting QLogic .hst file (host group) enabling refresh from host and target hardware requirements 3-1, alarms 5-19 HBA alias, definition of Glossary-3 eventlog.txt file HBA driver...
Page 144
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters help system installer browser, specifying location downloading from CD-ROM contents of downloading from QLogic Web site viewing selecting and starting host intended audience access password, setting...
Page 145
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters IPv6 Prefix List dialog box 6-15 logs IPv6 Router List dialog box 6-13 activity, saving (UNIX) 7-22 iqlremote agent activity, saving (Windows) 7-19 defined ARP, viewing...
Page 146
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters patch update file 4-22 path MTU NAS, definition of Glossary-4 definition of Glossary-5 neighbor IPv6 destination cache log 6-11 cache (IPv6), viewing 6-11 packet size, Ping page...
Page 147
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters root or administrator privileges 5-11 router QLogic IP address 6-14 contacting lifetime 6-14 technical support list log (IPv6), viewing 6-13 Web site, downloading installer from RPC (remote procedure calls)
Page 148
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters Solaris telephone number, contacting QLogic CLI installation on 4-17 terms, definitions of Glossary-1 SPARC/x86 driver structure Glossary-2 test parameters, setting 6-16 starting SANsurfer on testing, starting and stopping a ping...
Page 149
SANsurfer iSCSI HBA Manager User’s Guide Management Tool for QLogic iSCSI Host Bus Adapters updating SANsurfer 4-17 by package update 4-21 to 4-24 Web browser via Web 4-17 to 4-21 specifying for help user interface supported versions activity, tracing automatically 6-21 web_supported_update_iscsi_hba.txt...
Page 150
Red Hat, Inc. SPARC is a registered trademark of SPARC International, Inc. Sun, Java, JVM, Solaris, and Ultra are trademarks or registered trademarks of Sun Microsystems, Inc. SUSE is a trademark of Novell, Inc. All other brand and product names are trademarks or registered trademarks of their respective owners. Information supplied by QLogic Corporation is believed to be accurate and reliable.
Need help?
Do you have a question about the SANsurfer iSCSI HBA Manager and is the answer not in the manual?
Questions and answers