Q-Logic SN0054651-00 F guide

Troubleshooting

Tracing SANsurfer FC HBA Manager and Agent Activity (Debug)

Notes

S

7-22	SN0054651-00 F

Image 134

Q-Logic SN0054651-00 F manual

Contents

SANsurfer FC HBA Manager User’s Guide Document Revision History Changes Sections Affected Revision B changes Revision E changes Table of Contents Getting Started Installing SANsurfer FC HBA ManagerSystem Requirements Performing Diagnostics Troubleshooting Viii SN0054651-00 F List of Tables Page Preface What’s in this Guide Intended Audience Related Materials ‰ See Installation Checklist on Documentation Conventions Availability License AgreementsTechnical Support Training Contact Information Xvi SN0054651-00 F SANsurfer FC HBA Manager Overview Environments Features SANsurfer FC HBA Manager Overview Features Advanced Features Configurations System Overview Adapter Target Single-Ported Non-failover ConfigurationAdapter Simple Failover Configuration Adapter = Preferred path = Alternate path SAN or Cluster Configuration Host Host Y System RAID Configuration and LUN MaskingAdapters Installation Checklist Available Driver Features by Operating System Collect the Hardware and Software Function Enhanced Driver Inbox Driver Install the Hardware Install the Enhanced Driver Install any RAID Filter Drivers Install and Run SANsurfer FC HBA Manager Install the IP Communications Driver Non-Windows Configuration ParametersConfigure the Disks in the Operating System Linux Enhanced Driver Parameters NetWare Enhanced Driver Configuration Parameters Page System Requirements Hardware Requirements Software Requirements System Requirements Software Requirements Supported QLogic Adapters Installing SANsurfer FC HBA Manager Initial Installation Installation Options Configuration Option Installation Requirements Installation Instructions SANsurfer Download Selections Example Install SANsurfer Introduction Install SANsurfer Important Information Install SANsurfer Choose Product Features Installing SANsurfer FC HBA Manager Initial Installation Macintosh Installation Choose Product Features Previous SANsurfer Install Detected Message Click Restore Default Folder Install SANsurfer Select Shortcut Profile Windows Only Install SANsurfer Create Desktop Icon Selection Windows Only 10 Install SANsurfer Pre-Installation Summary 11 Install SANsurfer Installing SANsurfer 13 Install SANsurfer Default QLogic Failover Enable/Disable 14 Install SANsurfer Launch SANsurfer Application Installation Instructions Using CLI 15 Install SANsurfer Install Complete Solaris WindowsLinux Installation Instructions for VMware ESX To prepare your servers to manage the FC adapters remotely To check for tool updates Web- and CD-Based Installation UpdatesUpdating SANsurfer by Web Update Network Does Not Use Proxy Settings Network Requires Proxy Settings 18 Update SANsurfer Update Dialog Box Updating SANsurfer by Package Update To update the existing tool 20 Update SANsurfer Open Dialog Box 21 Update SANsurfer Update Dialog Box Uninstalling SANsurfer To uninstall SANsurfer FC HBA Manager 22 Uninstall SANsurfer Add/Remove Programs Windows 23 Uninstall SANsurfer Uninstall SANsurfer 24 Uninstall SANsurfer Uninstall Options 25 Uninstall SANsurfer Choose Product Features 26 Uninstall SANsurfer Uninstall SANsurfer Click Uninstall 27 Uninstall SANsurfer Uninstall Complete Getting Started Starting SANsurfer FC HBA Manager Starting SANsurfer FC HBA Manager on Windows To start SANsurfer FC HBA Manager on Windows Starting SANsurfer FC HBA Manager on Macintosh Connecting to Hosts Automatically Windows CLIStarting SANsurfer FC HBA Manager on Linux or Solaris To start SANsurfer FC HBA Manager on Linux or Solaris SANsurfer.app/Contents/MacOS To connect to a host automatically on Windows SANsurfer FC HBA Manager Main Window Signal Indicates To view the SANsurfer FC HBA Manager main window Toolbar Buttons Toolbar Buttons Toolbar Buttons „ Host icons Host Icons and TextAdapter Icons and Text „ Adapter Port Icons Adapter Port Icons and Text„ Adapter icons Device Icons and Text „ Device Icons LUN Icons and Text Exiting SANsurfer FC HBA ManagerGetting Help Viewing the Help System Specifying the Help Browser To specify a browser Viewing SANsurfer FC HBA Manager Tool Information To view information about SANsurfer FC HBA Manager Setting SANsurfer FC HBA Manager Security To set the tool access password for a host Security „ Press CTRL+SHIFT+T Setting the Warning Display OptionTo set the warning display option Setting the Configuration Change Option Options Dialog Box Configuration Change Setting Application Event Log Options To set event log options Setting the HBA Event Log Option To set HBA Event Log options Options Dialog Box HBA Event Log „ Press CTRL+SHIFT+M Setting Up Automatic Notification by E-mailTo set up automatic notification by e-mail „ Press CTRL+SHIFT+P Setting the Configuration PoliciesTo set the configuration policies 11 Policy Settings Dialog Box Getting Started Setting the Configuration Policies Getting Started Setting the Configuration Policies Forbidden Sharing of Devices or LUNs ‰ Proceed with LUN configurationTo configure shared devices Specifying the Adapter Driver Settings 13 Shared Components Dialog Box 14 Settings Page Adapter Driver To set the adapter driver parameters 15 Settings Page Linux Failover Driver Only Refreshing the Host Configuration Performing Diagnostics Running Loopback and Read/Write Buffer Diagnostic Tests Preparing for Diagnostic Testing Finding the Adapter Port You Want to Test To stop the LED from flashing Preparing for the Loopback TestTo flash the adapter port’s LED To prepare to run the loopback test Driver Versions That Do Not Require a Loopback Connector To install a loopback connector Preparing for the Read/Write Buffer Test To resume normal adapter operations To run a loopback test Running the Loopback TestRunning the Read/Write Buffer Test Viewing Adapter Port Transceiver Details To run a read/write buffer test General Media Information Diagnostic Data Details Transceiver Details Page Details Troubleshooting Tools Windows Event Log Linux Messages File SANsurfer FC HBA Manager Troubleshooting Problems and SolutionsSolaris Messages File Installation Issues Troubleshooting Installation Issues User Interface and Remote Agent Issues Troubleshooting User Interface and Remote Agent Issues Information see the SANsurfer FC HBA Manager Application That qlremote is Installed and Running on Functional Issues Troubleshooting Functional Issues Problem Verifying that the Adapter Driver is Installed To verify that the adapter driver is installed on Macintosh To verify that the adapter driver is installed on WindowsTo verify that the adapter driver is installed on Netware Verifying that qlremote is Installed and Running To verify that qlremote is installed and running on Windows Alternate Solaris procedure To verify that qlremote is installed and running on NetWareAlternate Linux procedure Tracing SANsurfer FC HBA Manager User Interface Activity Alternate Macintosh procedureTracing SANsurfer FC HBA Manager and Agent Activity Debug To trace SANsurfer FC HBA Manager user interface activity Local.properties File 4shows an example SANsurfer.lax File Example Command Prompt Properties Dialog Box Exporting or Saving the Agent Logs Exporting or Saving Agent Activity LogsAgent Logs by Operating System To export agent activity on Solaris SN0054651-00 F Page Frequently Asked Questions Frequently Asked Questions SN0054651-00 F Shortcut Keys CTRL+SHIFT+Z Arbitrated loop Boot codeBoot device CSV file Device Driver Enhanced Ethernet Echo diagnostic testFlash Bios Fabric ISCSI HBA port beaconIoctl Load balancing Port PathPoint-to-point QoS T11 Target binding Index Index-2 SN0054651-00 F SN0054651-00 F Index-3 Index-4 SN0054651-00 F SN0054651-00 F Index-5 Index-6 SN0054651-00 F Wwpn Page Page Page SN0054651-00 F SN0054651-00 F SN0054651-00 F