Home

Q-Logic MP3 User's Manual

1. 7 3 Troubleshooting Problems and Solutions 7 3 Installation Issues 7 4 User Interface and Remote Agent Issues 7 5 Functionallssues 7 8 Verifying that the Adapter Driver is Installed 7 10 Verifying that qlremote is Installed and Running 7 12 Tracing SANsurfer FC HBA Manager and Agent Activity Debug 7 14 Tracing SANsurfer FC HBA Manager User Interface Activity 7 14 SN0054651 00 F vii SANsurfer FC HBA Manager User s Guide pad Management Tool for QLogic FC and FCoE Adapters LOGIC Exporting or Saving Agent Activity Logs 7 19 Agent Logs by Operating System 7 19 Exporting or Saving the Agent Logs 7 19 A Frequently Asked Questions B Shortcut Keys Glossary Index List of Figures Figure Page 2 1 Single Ported Non failover Configuration 2 2 2 2 Simple Failover Configuration 2 3 2 3 SANor Cluster Configuration 2 4 2 4 RAID Configuration and LUN Masking 2 5 4 1 SANsurfer Download Selections Ekample 4 4 4 2 Install SANsurfer Introduction
2. 4 24 4 21 Update SANsurfer Update Dialog Box 4 25 4 22 Uninstall SANsurfer Add Remove Programs Windows 2000 4 27 4 23 Uninstall SANsurfer Uninstall SANsurfer 4 28 4 24 Uninstall SANsurfer Uninstall Options 4 29 4 25 Uninstall SANsurfer Choose Product Features 4 30 4 26 Uninstall SANsurfer Uninstall SANsurfer 4 31 4 27 Uninstall SANsurfer Uninstall Complete 4 32 viii SN0054651 00 F XX SANsurfer FC HBA Manager User s Guide LOGIC Management Tool for QLogic FC and FCoE Adapters ada JP 5 1 SANSUNG O ICOM aiaia KK BABAIT aes Se Aa AHA eee eo R a a Pee ee 5 2 5 2 SANsurfer FC HBA Manager Main Window 5 7 5 3 Browser Location DialogBOK 5 14 5 4 About SANsurfer FC HBA Manager Window 5 15 5 5 SeCUY Ag ahah eaten srki aa ikan AA 5 17 5 6 Options Dialog Box Warning Displays 5 18 5 7 Options Dialog Box Configuration Change 5 19 5 8 Options Dialog Box App Event Log 5 21 5 9 Options Dialog Box HBA Event Log 5 22 5 10 Email Settings Dialog Box
3. 5 23 5 11 Policy Settings DialogBoK 5 25 5 12 Shared Device Found Dialog Box 5 28 5 13 Shared Components Dialog Box 5 29 5 14 Settings Page Adapter Driver 5 30 5 15 Settings Page Linux Failover Driver Only 5 31 6 1 Transceiver Details Page General Page 6 8 6 2 Transceiver Details Page Details Page 6 10 7 1 Windows Services ve iwrst nears dnkces BNG deaw awd WEEE eestor ee a ee 7 12 7 2 Local properties File 7 15 7 3 Agent properties File 7 15 7 4 SANsurfer lax FileEkample 7 17 7 5 Command Prompt Properties Dialog Box 7 18 List of Tables Table Page 2 1 Available Driver Features by Operating System 2 7 4 1 Configuration Option Installation Reguirements 4 2 5 1 Traffic Signals eiseres KAKA Rha Re eRe ee REED REE AGE KAL SRE wa Ree aR eed 5 6 5 2 Toolbar Buttons 285 gawa a hehe eee Vib ee hoes wie dees hen de awe Bee ag ee 5 7 6 1 Driver Versions That Do Not Require a Loopback Connector 6 4 7 1 Troubleshooting Installation Iss
4. 5 2 Starting SANsurfer FC HBA Manager on Linux or Solaris 5 3 Starting SANsurfer FC HBA Manager on Macintosh 5 3 Connecting to Hosts Automatically Windows CLI 5 3 Connecting to Hosts Automatically Linux Solaris or Macintosh CLI 5 4 SANsurfer FC HBA Manager Main Window 5 5 Toolbar Buttons 5 7 Host Icons and Tekt 5 9 Adapter Icons and Tezt 5 9 Adapter Port Icons and Text 5 10 Device Icons and Tekt 5 11 LUN Icons and Tezt 5 12 Exiting SANsurfer FC HBA Manager 5 12 Getting Help i ssp paac aasa ka eecshema eaeedeaweneedae NG kwaa 5 12 Viewing the Help System 5 13 Specifying the Help Browser 5 14 Viewing SANsurfer FC HBA Manager Tool Information 5 15 SN0054651 00 F XX SANsurfer FC HBA Manager User s Guide LOGIC Management Tool for QLogic FC and FCoE Adapters Setting SANsurfer FC HBA Manager Security 5 16 Setting the Warning Display Option 5 18 Setting the Configuration Change Option 5 19 Setting Application Event Log Options 5 20
5. f you want the warning dialog boxes to appear select the Enable Warning Displays check box Enabled is the default E fyou do not want the warning dialog boxes to appear clear the Enable Warning Displays check box 3 When you finish making selections do one of the following m To save the changes and close the Options dialog box click OK m To close the Options dialog box without saving any changes click Cancel 5 18 SN0054651 00 F XX Getting Started LOGIC Setting the Configuration Change Option aaa Setting the Configuration Change Option SANsurfer FC HBA Manager keeps current the devices and the LUNs that the adapter shows When cables are pulled devices are hot plugged into the SAN or devices are removed SANsurfer FC HBA Manager generates a configuration event in the HBA Event Log To set how SANsurfer FC HBA Manager handles configuration changes 1 To access the Options dialog box choose one of the following methods m Onthe SANsurfer FC HBA Manager main window open the Settings menu and then click Options m Right click the FC CNA HBA tree and then on the shortcut menu click Options m Press CTRL SHIFT T The Options dialog box opens Figure 5 7 Configuration Change Apply Configuration Changes Automatically Confirm Configuration Change Applies Ignore Configuration Changes Figure 5 7 Options Dialog Box Configuration Change 2 Under Configuration Change do one of the
6. m Adjunct driver level works along side a driver at the same level to increase performance In NetWare the required drivers include m Host Adapter Module HAM is the driver component associated with the host adapter hardware It provides the functionality to route requests to the bus where a specified device is attached Glossary 2 Em Custom Device Module CDM is the driver component associated with storage devices It provides the functionality to build device specific commands from I O messages received from NetWare s Media Manager In Red Hat SUSE Linux the driver layers include E SCSI Upper Layer is the device management layer It handles device dependent tasks for devices such as disks and tapes Em SCSI Middle Layer is the SCSI traffic handling layer It directs requests between the kernel and the SCSI m SCSI Lower Layer is the SCSI adapter driver It communicates directly to the SCSI adapter The structure for Solaris SPARC x86 drivers includes m Nexus drivers provide bus mapping and translation services to subordinate nexus and leaf devices These include drivers for PCI to PCI bridges PCMCIA adapters and SCSI adapters m Leaf drivers provide the traditional character and block driver interfaces for reading and writing data to storage and communication devices These include drivers for peripheral devices including QLA2xxx adapters disks tapes network adapters and frame buffers
7. 4 5 4 3 Install SANsurfer Important Information 4 6 4 4 Install SANsurfer Choose Product Features 4 7 4 5 Macintosh Installation Choose Product Features 4 9 4 6 Install SANsurfer Choose Install Folder 4 9 4 7 Previous SANsurfer Install Detected Message 4 10 4 8 Install SANsurfer Select Shortcut Profile Windows Only 4 11 4 9 Install SANsurfer Create Desktop Icon Selection Windows Only 4 12 4 10 Install SANsurfer Pre Installation Summary 4 13 4 11 Install SANsurfer Installing SANsurfer 4 14 4 12 Install SANsurfer Novell NetWare Disk Selection 4 14 4 13 Install SANsurfer Default QLogic Failover Enable Disable 4 15 4 14 Install SANsurfer Launch SANsurfer Application 4 16 4 15 Install SANsurfer Install Complete 4 17 4 16 Update SANsurfer Select Update Dialog BOK 4 20 4 17 Update SANsurfer Server Proxy Settings Dialog Box 4 21 4 18 Update SANsurfer Update Dialog Box 4 22 4 19 Update SANsurfer Select Update DialogBOK 4 23 4 20 Update SANsurfer Open DialogBOK
8. Installation Options SANsurfer FC HBA Manager supports both stand alone and networked configurations as shown in Table 4 1 Install the management tools appropriate for your configuration Table 4 1 Configuration Option Installation Requirements Configuration Management Tool Requirements Stand alone System This Windows XP Professional Windows 2000 Windows Server 2003 Windows Vista Win dows Server 2008 IA32 IA64 or x64 or Red Hat SUSE Linux IA32 system locally monitors QLA2xxx adapters This Red Hat SUSE Linux IA64 x64 or Solaris SPARC x86 or Macintosh system locally monitors QLA2xxx adapters Networked System This system locally monitors QLA2xxx adapters and remote systems on the same network This system monitors QLA2xxx adapters only on remote systems on the same network The QLA2xxx adapters on this system are remotely monitored only from other systems on the same network SANsurfer FC HBA Manager user interface SANsurfer FC HBA Manager user interface plus one of the following m SANsurfer FC Linux Agent m SANsurfer FC Solaris Agent E SANsurfer Mac OS X FC Agent SANsurfer FC HBA Manager user interface plus one of the following m SANsurfer FC Windows Agent m SANsurfer FC Linux Agent m SANsurfer FC Solaris Agent E SANsurfer Mac OS X FC Agent SANsurfer FC HBA Manager user interface One of the following m SANsurfer FC Windows Agent m SANsurfer FC Linux Agent m SANsur
9. NOTE Specific warning flags may represent the manufacture s end of life indicators SN0054651 00 F 6 9 Performing Diagnostics pad Viewing Adapter Port Transceiver Details LOGIC coo aaa Details Page The Details page Figure 6 2 of Transceiver Details shows detailed digital diagnostic data from the optical transceiver device Diagnostics General Diagnostics Transceiver Details Hostname n711 2av59v5nb1 10 3 20 38 Node Name 05 05 05 E0 88 05 05 05 HBA Model QLA2460 Port Name 05 05 05 E0 8B 05 05 05 HBA Port 1 Port ID 00 00 00 General Details Vec High Alarm Md Temp Low Alarm 0x0 Temp High Alarm 0x0 RX Signal Power Low Alarm Oxt RX Signal Power High Alarm 0x0 TX Signal Power Low Warming 0x0 TX Signal Power High Warming 0x0 TX Bias Low Waming 0x0 TX Bias High Warning 0x0 Vec Low Warning 0x0 Vec High Warning 0x0 Temp Low Warning 0x0 Temp High Warning 0x0 Reserved Waming 0x0 Reserved Waming 0x0 Reserved Warming 0x0 Reserved Waming 0x0 Reserved Waming 0x0 Reserved Waring 0x0 RX Signal Power Low Warning Oxt RX Signal Power High Warning 0x0 Vendor Specific 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x01 Refresh q T Figure 6 2 Transceiver Details Page Details Page For a detailed explanation of the diagnostic data displayed on the Details page refer to SFF 8472 Specification for Diagnostic Monitoring Interface for Optical Xcvrs Revision 9 3 August 1
10. PIA NN Be Para Ng ita kn kta kn Ki kta 4 NG 50 AS Pe Mm ANA Pesce tet NAA KA KA KA eee Controllers Na Ng aoe NG A Pg cf SA Ng pe cece Ng Ni z 3 Pg Ng Ng Pa Ng Ni he Ni Figure 2 4 RAID Configuration and LUN Masking Figure 2 4 is a generic example of a RAID configuration Many but not all RAID systems operate in this manner The following paragraphs describe this configuration E All hosts and storage devices are connected to a common fabric Details of fabric configuration are not important except to note that all hosts and adapters can connect to all storage devices Depending on the fabric some devices may appear on the local loop and as fabric devices E Hosts X and Y must be configured to recognize different target devices or else risk overwriting each other s data SANsurfer FC HBA Manager must be run on each host to configure devices as enabled with a preferred and alternate path assigned to each device or disabled m fhosts X and Y are cooperating in a cluster they can be configured so that both recognize a specific device In this case clustering software and the clustered application must determine which host is permitted to write to the device SN0054651 00 F 2 5 System Overview pad Installation Checklist QLOGIC E e m Host Z not shown can be added to this configuration SANsurfer FC HBA Manager supports up to 30 h
11. a Nn Host Y Adapters LUNs 4 7 er Wa Ka Pa ty NA karata Wa Ka ng NANANG ia NA uana kalala laa bada Ot Big Mag Mag Mig Mag Mog ty PA a GG Ng Para ieee ao Ng kn KK Mag Mig Mag Mog ig ig Mig Mag Mag Mog tig Mag Mig Mag Mog Mog Big Mig Mig Mig Mag Mog Sig Mig Mag Mag Mog Mog Mog ng Pa kn Ps Sagar ate tata ae ia gt nat ta Ni ri a j iat ita Ng Ni Na mp ty Pee Papa a iat NG kn ita an kataa aa alala tala agn Ng KA Mog Mog Mog kn zaa vo ta Pata KM Mag Mog Mog Mog Moe Moa Moa Mog Ps nn AA kn Cc Ty A oe nas WA Ni fe Pi ee py pe a aa oe a of N ir Hana ita pba KAA oe i bai Na ms Ni NG AAA kn KM Mog Mog oe oe oe Nog oe Moe og Ps SAT Cf 4 7 0 a Na aaa nag 2 09 za See 2 any cet pa PA T ata Ng fs Sag Mig Mag Mog Mog Mog Mog Mog oe Moe oe oe og ty AAA UA BAN Patang Ng TETEA mat Ps kn kn ty kn kn AAA oe oe oe og Kg Nig Mag Mag Nag Mog Mog Mog Moe Moe og oe oe oe oe oe oe oe oe oe og Bg Nag Mag Mag Mog Mog Mog Noe Mogg oe oe oe oe oe oe oe oe oe oe og i EE ne KG NG Ha ia ia lates NA late sate Pirata tatas Kara Kara KS Ca a 6 Pataas kn kn kta 2 a x gt
12. 1 Type the following command and then press ENTER ps e grep qlremot 2 If entries display qlremote is running Alternate Solaris procedure Go to the SANsurfer installation folder 2 Type the following command and then press ENTER qlremote v 3 Verify that the appropriate network protocol is running To verify that qlremote is installed and running on Macintosh 1 Type one of the following commands and then press ENTER ps ax grep qlremote ps ef grep qlremote 2 Tfentries display qlremote is loaded SN0054651 00 F 7 13 Troubleshooting pad Tracing SANsurfer FC HBA Manager and Agent Activity Debug LOGIC AA NY Alternate Macintosh procedure 1 Goto the SANsurfer installation folder 2 Type the following command and then press ENTER qlremote v 3 Verify that the appropriate network protocol is running Tracing SANsurfer FC HBA Manager and Agent Activity Debug Additional information may be required to help troubleshoot SANsurfer FC HBA Manager problems After you enable the debug feature following the steps in this section attempt to reproduce the problem to capture the SANsurfer FC HBA Manager and agent activity Use the following procedures to trace SANsurfer FC HBA Manager user interface and agent activity debug as directed by your authorized service provider This section provides procedures for m Tracing SANsurfer FC HBA Manager User Interface Activity on page 7 14 m
13. sional Windows 2000 Windows Server 2003 Windows Vista Windows Server 2008 Solaris SPARC x86 Red Hat SUSE Linux Macintosh OS X and NetWare The SANsurfer FC HBA Manager user interface running on any platform can talk to any other platform running the agent The SANsurfer FC HBA Manager interface allows connections to different platforms at the same time SANsurfer FC HBA Manager actively pings the agent at the specified broadcast interval This allows SANsurfer FC HBA Manager to detect agent presence on all platforms even if agent shutdown notification is not supported It also allows the detection of agent crashes as soon as pos sible During an agent crash the notification may not have been sent to all the connected user interfaces The alarm and event log files are stored in the SANsurfer FC HBA Manager install directory as a comma delimited list of entries one per line The alarm log file is alarms txt and the event log file is events txt No SANsurfer FC HBA Manager currently does not run as a Java applet No SANsurfer FC HBA Manager currently supports only the RPC communication layer between the user interface and agent SN0054651 00 F Frequently Asked Questions pad QLOGIC Ce Notes A 2 SN0054651 00 F XX LOGIC The Ultimate in Performance B Snortcut Keys What are shortcut keys You can quickly accomplish tasks you perform frequently by using shortcut keys one or more keys you press o
14. 2002 6 10 SN0054651 00 F XX LOGIC The Ultimate in Performance Troubleshooting Problems can occur when installing and using SANsurfer FC HBA Manager This section provides troubleshooting information including m Troubleshooting Tools on page 7 1 m Troubleshooting Problems and Solutions on page 7 3 m 8 Verifying that the Adapter Driver is Installed on page 7 10 Verifying that qlremote is Installed and Running on page 7 12 m Tracing SANsurfer FC HBA Manager and Agent Activity Debug on page 7 14 as directed by your authorized service provider NOTE The qlremote agent refers to the SANsurfer FC HBA Manager server agent SANsurfer FC Windows agent SANsurfer FC Linux agent SANsurfer FC Solaris agent SANsurfer FC NetWare 5 6 x agent or SANsurfer FC Mac OS X agent with which the SANsurfer FC HBA Manager user interface client connects to manage QLogic QLA2xxx FC adapters Troubleshooting Tools The following sections explain how to use the Windows event log Linux messages file Solaris messages file and SANsurfer FC HBA Manager to solve hardware problems Windows Event Log The Windows event log is the main source of information for device driver problems and events Device drivers usually indicate only status by logging events in the system event Log SANsurfer FC HBA Manager agents also use the Application Event Log to report service errors and so on For more informat
15. 5 7 Getting Started SANsurfer FC HBA Manager Main Window XX QLOGIC ee Collect til Monitor D Diags Table 5 2 Toolbar Buttons Continued Button Purpose Click the App Events button to open the App Events log where you can review the events that occur on your host and manage the App Events log information See Viewing and Managing the App Event Log in the help system Click the HBA Events button to open the HBA Events log where you can review the HBA events that occur on your host and manage the HBA Events log information See Viewing and Managing the HBA Events Log in the help system Click the Collect button to automatically save the following files in one zip file E Host to a text file E Host toa qlc file E App Event log to a text file E HBA Event log to a text file See Using Collect in the help system Click the Monitor button to open the HBA Statistics dialog box and monitor the various functions of the adapter See Viewing and Updat ing Adapter Port Monitoring in the help system Click the Diags button to open the HBA Diagnostics dialog box which provides access to the diagnostics tests loopback and read write See Performing Diagnostics on page 6 1 Click the Refresh button to query the host and update any information on the Adapters connected to the host See Refreshing the Host Con figuration on page 5 32 NOTE Yo
16. CAUTION At this stage a dual port device may appear under the operating system as two distinct devices This situation is normal you can resolve this later by configuring one path to the device as an alternate path If one device is configured as two devices do not write data to this device because it can confuse the file system SN0054651 00 F 2 9 System Overview pad Installation Checklist QLOGIC ee Verification Verify that adapters recognize target devices by using operating system device configuration utilities or use the SANsurfer FC HBA Manager to display target devices found on an adapter To mask devices or LUNs or if devices appear twice because you plan to configure them later as preferred and alternate paths do not format devices assign drive letters or save this disk configuration E In Windows use the computer management utility to view which target devices are configured on which adapters and to view and format devices and LUNs that are found H In NetWare use the Scan all LUNs and List Storage Adapters commands to view which target devices are configured on which adapters You can use the nwconfig or hdetect utility to view the devices and LUNs found a In Linux open var log messages to view which target devices are configured on which adapters Entries are also created for each adapter recognized by the driver Each entry contains information about target devices and LUNs that are found a In Solar
17. General Details Media Information Vendor JOS UNIPHASE Type 400 M6 SN I Part Number JSJ 42S4AE2 Speed 100 MByles Sec 200 MBytes Sec 400 MBytes Sec Revision Serial Number 4254085417 Diagnostic Data Temperature C Voltage V Tx Bias mA Tx Power mV Rx Power mw val 44 75 3 34 6 96 0 373 0 000 100 00 4 50 15 00 0 794 0 328 70 00 4 00 14 00 0 398 0 165 ILO 3 0 0 si 0 11 ot JU 0 50 00 2 00 2 00 0 079 0 002 Refresh O Figure 6 1 Transceiver Details Page General Page Media Information 6 8 On the General page the Media Information section lists the following information E Vendor Indicates the name commonly accepted abbreviation SCSI company code or the stock exchange code for the company that provides the transceiver device E Part Number Indicates the vendor part number or product name of the transceiver device A value of zero indicates that the part number is unknown Ho Revision Indicates the vendor product revision number of the transceiver device A value of zero indicates that the revision number is unspecified SN0054651 00 F pad Performing Diagnostics LOGIC Viewing Adapter Port Transceiver Details I Serial Number Indicates the vendor serial number for the transceiver device m Type Describes the transceiver device based on information that SANsurfer FC HBA Manager reads from the device For instance the type 400 M6 SN I describes a transceive
18. Sa nabanga rodas Ra Network Provisioning Service T Local Heare and Groups Stop the service Ba NT LM Security Support Provider n a Seles ang and Alert Restart the service 84 ONC RPC Portmapper 3 Storage Rp Performance Logs and Alerts Removable Storage Plug and Play Disk Defragmenter a Portable Media Serial Number Serv Disk Management Sa Print Spooler Bi E a Services and Applications By Protected Storage 3 Telephony OLManagementAgentJava Services a OLPartitionAgent WMI Control Remote Access Auto Connection M g 23 Indexing Service Co aa ma oft 4 DA Extended Figure 7 1 Windows Services 7 12 SN0054651 00 F XX Troubleshooting QLOGIC Verifying that qlremote is Installed and Running TO HOO To verify that qlremote is installed and running on NetWare 1 At the server command prompt type the following command and then press ENTER modules q 2 Verify that qlremote nlm is loaded To verify that qlremote is installed and running on Red Hat SUSE Linux 1 Type one of the following commands and then press ENTER ps ax grep qlremote ps ef grep qlremote 2 Tfentries display qlremote is loaded Alternate Linux procedure 1 Change to the following directory cd usr local bin 2 Type the following command and then press ENTER qlremote v 3 Verify that the appropriate network protocol is running To verify that qlremote is installed and running on Solaris SPARC x86
19. The parameter value is ConfigRequired 1 TRUE in Linux Macintosh Basic Parameters QLogic configuration parameters are stored in two files etc QLogicHBA23xx conf System Library Extensions QLogicHBA23xxConfig kext Contents QLogicHBA23xxConfig This is a config module binary The qla_opts utility in the source code of Failover API can read the config file and write to the config module 2 12 SN0054651 00 F XX System Overview QLOGIC Non Windows Configuration Parameters TO HOO NetWare Enhanced Driver Configuration Parameters NetWare stores QLogic configuration parameters in the 012x00 cfg file in the default DOS directory C Nwserver The NetWare agent creates and saves parameter values in the file this file is not intended for modification nor editing SN0054651 00 F 2 13 System Overview pad Non Windows Configuration Parameters OLOGIC a yy Notes 2 14 SN0054651 00 F XX LOGIC The Ultimate in Performance 3 System Requirements For optimum performance the SANsurfer FC HBA Manager requires the hardware and software listed in this section m Hardware Requirements on page 3 1 E Software Requirements on page 3 2 m Supported QLogic Adapters on page 3 4 Hardware Requirements The minimum hardware requirements are as follows mB QLogic QLx2xxx PCI to Fibre Channel adapters or QLE8042 converged network adapters see Supported QLogic Adapters on page 3 4 m S
20. on page 1 4 Problem categories include HO Installation Issues on page 7 4 m User Interface and Remote Agent Issues on page 7 5 m Functional Issues on page 7 8 SN0054651 00 F 7 3 Troubleshooting pad Troubleshooting Problems and Solutions LOGIC ee Installation Issues Table 7 1 lists problems that can occur when installing SANsurfer FC 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 E f running from CD ROM verify that the installation is run from the start page If JavaScript is turned on in the browser the CD ROM automatically detects the operating system and presents the appro priate installation program E If the installation program was downloaded it may be corrupted Download the program again this time to a different directory per form the installation Installation does not complete Cause There is insufficient disk space or not enough available mem or terminates before comple ory tion Solution The installation detects when there is insufficient disk space When sufficient disk space is available continue the installation For disk space and physical RAM requirements see Hardware Require ments on page 3 1 or the readme txt file Instal
21. require password authorization SANsurfer FC HBA Manager prompts for the password when you change the following Adapter parameters Flash BIOS Adapter driver Failover configuration Persistent configuration data Port configuration LUN configuration Device replacement Password when you want it changed You can change the SANsurfer FC HBA Manager access password for any host connected to your system for which you have administrator or root privileges NOTE The default SANsurfer FC HBA Manager access password is located in the readme txt file To ensure that security is not compromised change this password after installation To set the tool access password for a host 1 In the SANsurfer FC HBA Manager main window FC CNA HBA tree select the host for which you want to set the tool access password 2 Click the Security tab The Security page opens Figure 5 5 The host name appears at the top of the page 5 16 SN0054651 00 F XX QLOGIC Getting Started Setting SANsurfer FC HBA Manager Security ee Information Topology V Statistics Security Hostname n7105avy 19004 Set New Password Host Access Login Password Application Access Current Password New Password Verify New Password Apply Clear Fields SN0054651 00 F Figure 5 5 Security Page Under Host Access verify that you have administrator or root priv
22. stored in the adapter NVRAM which you can modify using Fast UTIL or the SANsurfer FC HBA Manager Linux Messages File For Red Hat SUSE Linux systems the Linux messages file is the main source of information for device driver problems and events Device drivers usually indicate only status by logging events in the Linux messages file SANsurfer FC HBA Manager agents also use the Linux messages file to report service errors and so on For more information see the SANsurfer FC HBA Manager Application Help The Linux agent logs events for significant driver errors In addition you can configure the Linux agent to perform extended event logging for an adapter which causes it to log all loop transitions and many minor events Extended Application Event Logging uses extra overhead and is enabled only in troubleshooting situations The extended event logging flag is stored in the adapter parameters which you modify using Fast UTIL or the SANsurfer FC HBA Manager The path for the Linux messages file is var log messages 7 2 SN0054651 00 F XX Troubleshooting QLOGIC Troubleshooting Problems and Solutions lls Solaris Messages File For Solaris SPARC x86 systems the Solaris messages file is the main source of information for device driver problems and events Device drivers usually indicate only status by logging events in the Solaris messages file SANsurfer FC HBA Manager agents also use the Solaris messages file to report service err
23. x x x se Serve Driver Fabric support x x x PENE Meare x gt lt x Enhanced Driver x x x Bite Optimized oper ation QLdirect type filter driver Alternate path Device X X X X X X selection and masking Static load X X X X X balancing SN0054651 00 F 2 7 System Overview pad Installation Checklist QLOGIC ee Table 2 1 Available Driver Features by Operating System Continued Windows Linux Windows Solaris Mac VMware Solaris NetWare Mac VMware be i i i 1 1 o o 2 2 2 2 Bele sole Wess aslo L L SANsurfer Function 5 ns D Fe D T D o FC HBA E O Q o m 9 o Manager 9 je c c E c 2 2 A A 9 2 2 wi uw wi wi Device replace X X X X X ment without rebooting Secure device X access Heterogeneous X support man ages multiple host types Win dows Linux Solaris Mac IP support X X Device SAN X X management NOTE The SANsurfer FC HBA Manager has the following features disabled m Load balancing m Failover watcher current path 2 8 SN0054651 00 F XX System Overview LOGIC Installation Checklist AA Step 2 Install the Hardware Refer to hardware installation guides to install adapters in host systems see Related Documents on page 1 4 Cable target devices through the combination of local loops hubs and switches in your configuration Verifica
24. 19 Select Update D From the QLogic website Browse 1 n Continue Cancel L BHB J Figure 4 19 Update SANsurfer Select Update Dialog Box 2 Toselect a file click Browse and then click LL To exit the Select Update dialog box and return to the main SANsurfer FC HBA Manager window click Cancel SN0054651 00 F 4 23 Installing SANsurfer FC HBA Manager IK Web and CD Based Installation Updates LOGIC AA 7a rr The Open dialog box appears Figure 4 20 Look in 171p co la co es D web_supported_update_fc_hba txt File Name web supported update fc hba dt Files of Type Update Lookup File TXT v Open Cancel Figure 4 20 Update SANsurfer Open Dialog Box 3 Select the SANsurfer FC HBA Manager patch update file web supported update fc hba txt which can be located on a local file system or on a CD DVD or portable storage device and then click Open To exit the Open dialog box and return to the Select Update dialog box click Cancel 4 24 SN0054651 00 F XX Installing SANsurfer FC HBA Manager LOGIC Web and CD Based Installation Updates I After you open the patch update file the Update dialog box opens Figure 4 21 showing available update information 2 0 30b85 2 0 30b84 Critical Update Status Pending Size 21 9MB Description SANsurfer SANsurfer FC HBA Manager General application update Figure 4 21 Update SANsurfer Update Di
25. 26 sansurfer exe 5 2 SANsurfer lax file editing 7 15 saving browser location 5 14 files 5 8 local properties to file 7 16 tool log from Event Viewer 7 19 SCSI layers Glossary 2 search help system 5 13 Security page setting access password 5 16 security setting 5 16 Select Shortcut Profile dialog box installation 4 11 Select Update dialog box 4 20 4 23 4 24 Server Proxy Settings dialog box 4 21 Settings page adapter driver settings 5 29 SFF 8472 1 3 6 7 6 10 Shared Components dialog box 5 28 Shared Device Found dialog box 5 26 5 28 sharing devices and LUNs policies for 5 24 shortcut keys B 1 Index 6 show help system navigation pane 5 13 simple failover system configuration 2 3 software required for SANsurfer FC HBA Manager 2 7 3 2 Solaris SPARC connecting to hosts automatically 5 4 messages file 7 3 starting SANsurfer FC HBA Manager on 5 3 Solaris x86 AMD64 connecting to hosts automatically 5 4 messages file 7 3 starting SANsurfer FC HBA Manager on 5 3 SPIFFI Glossary 6 SSID SSVID missing 7 9 stand alone configuration 4 2 starting SANsurfer FC HBA Manager 5 1 startup procedures 5 1 Linux 5 3 Macintosh 5 3 Solaris 5 3 Windows 5 2 status of hosts viewing 5 5 Subsystem Identification Subsystem Vendor Identification SSID SSVID missing 7 9 SYSFS Glossary 6 sysfs IOCTL module 2 12 system configurations 2 1 RAID and LUN masking 2 5 SAN or cluster 2 4 simple failover 2 3 single ported non failover 2
26. 3 Loop Down fa FCoE Engine m Adapter Port Icons BP Good 2 Beacon Flashing Good 5 10 Bi Warning Warning alarm Ef Loop Down Bad Bad alarm gt Offline Adapter port on offline host SFP not installed for 8Gb adapter Be Beacon Flashing Warning Et Loop Down Beacon Flashing 4 Beacon Flashing Bad fa FCoE Engine for QLE8042 SN0054651 00 F XX Getting Started LOGIC SANsurfer FC HBA Manager Main Window rr 8 Ha Device Icons and Text The FC CNA HBA tree shows the following information about disks tapes and SAFTE devices a Device type Disk tape or SAFTE used for enclosure information H Device port ID Port ID of the disk tape or SAFTE device Online Inactive Status A circled red X on the icon indicates an inactive device either the device is down the port on device is down or inactive or the device is not responding properly to SCSI commands m Diagnostics enabled disabled for read write buffer test A green check mark on the icon and the text Diag Enabled indicate enabled For more information see Preparing for Diagnostic Testing on page 6 2 m Beacon Flashing Flash Beacon LED beacon flashing function is enabled see Finding a Target in the help system Examples Disk 50 06 0E 83 00 00 2B 21 Online Diag Disabled s3 Disk 21 00 00 04 CF 92 7A B1 Online Diag Enabled Tape 10 00 00 04 32 72 06 64 Inactive Diag Disabled m Device Icons The disk icons ar
27. Cancel Figure 4 9 Install SANsurfer Create Desktop Icon Selection Windows Only 9 Windows only If you want the installer to place the SANsurfer icon on the desktop select the create desktop icon check box default and then click Next 4 12 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Initial Installation TO A NOTE If you select the create desktop icon check box the SANsurfer icon opens for the current user profile or all user profiles depending on your previous selection in Step 8 The Pre Installation Summary dialog box Figure 4 10 opens o SANsurfer FC HBA Manager Pre Installation Summary Please Review the Following Before Continuing SANsurfer eine XX OLOGIC Product Name SANsurfer FG HBA Manager Install Folder C Program Files Shortcut Folder G Documents and Settings All UsersiStart Menu Programs iQLogic Management Suite Disk Space Information for Installation Target Required 152 776 445 bytes Available 107 118 505 984 bytes InstallAnywhere by Macrovision Cancel Previous Install Figure 4 10 Install SANsurfer Pre Installation Summary 10 Review your installation selections To change your selections click Previous to return to other installation windows To continue click Install The Installing SANsurfer dialog box opens Figure 4 11 Various messages inform you that the installation is progressing SN0054651 00 F 4 13 In
28. Choose Installanywhere by Macrovision Cancel Previous Net Figure 4 6 Install SANsurfer Choose Install Folder SN0054651 00 F 4 9 Installing SANsurfer FC HBA Manager pad Initial Installation QLOGIC AA NN 6 Select an install location using one of the following methods NOTE For NetWare select the drive mapped to the NetWare server always select a location other than the default m To accept the destination location shown in the dialog box and continue click Next recommended The default location for a Windows system is C Program Files QLogic Corporation SANsurfer The default location for a Red Hat SUSE Linux and Solaris SPARC x86 system is opt QLogic Corporation SANsurfer m To select a different location a Click Choose and then select an installation location b On the Choose Install Folder dialog box click Next m iif you selected a different location and want to reselect the default location a Click Restore Default Folder b Click Next If there is a previous version of the SANsurfer tool on the system the Previous SANsurfer Install Detected message box appears Figure 4 7 Previous SANsurfer Install Detected F x O Previous SANsurfer Install Detected The Previous Install Location Detected is C Program Files QLogic Corporation sSANsurfer Would you like to uninstall the previous install Please exit the SANsurfer application if currenly running before runn
29. Exporting or Saving Agent Activity Logs on page 7 19 Tracing SANsurfer FC HBA Manager User Interface Activity To trace SANsurfer FC HBA Manager user interface activity 1 Edit the local properties file which is located where SANsurfer is installed Change the following properties See Figure 7 2 node trace level 900 node trace output setlevelonly fals 7 14 SN0054651 00 F XX Troubleshooting QLOGIC Tracing SANsurfer FC HBA Manager and Agent Activity Debug ls j local properties Notepad Fie Edt Search Help node config auto confirnm false node policies enable true node trace output file false node allow nmulti active true node refresh button enable false node config single button false node last host connected wsnat4sys3 node utilities flash button enable true contro19 method instance node event log informational true node config supported platforms windows linux solaris netware sunos node option warning persist enable true node adapter info pci enable true node config device replacement disable false node broadcast enable true node trace output file filename troutput txt node config allow multiple lun dialogs false node option config spiffi check enable true Figure 7 2 Local properties File 2 Edit the agent properties file which is located where SANsurfer is installed Change the following property See Figure 7 3 node agent quiet model enable 0 P a
30. In addition you can export the statistics to a comma separated values CSV file which can be imported into other applications for example Microsoft Excel m Adapter diagnostics SANsurfer FC HBA Manager provides end to end diagnostics that enable you to test the adapters and the devices to which they are connected SANsurfer FC HBA Manager diagnostics allow you to do the following Test the link status of each adapter and its attached devices Q Perform a loopback test which is external to the adapter to evaluate the ports transmit and receive transceivers on the adapter and the error rate u Perform a read write buffer test which tests the link between the adapter and its attached devices 1 Run diagnostics on small form factor pluggable SFP transceivers per SFF 8472 Specification for Diagnostic Monitoring Interface for Optical Xcvrs Revision 9 3 August 1 2002 U View transceiver details E Application event and adapter event notifications SANsurfer FC HBA Manager provides asynchronous notification of various conditions and problems through alarms and events Alarm information includes severity time host adapter application and description Event information includes severity time and message In addition you can export the alarm and event information to a CSV file which can be imported into other applications such as Microsoft Excel Alarm information can be sent automatically by email to a dis
31. Login lt enter valid login here gt enter valid email company domain Test Notification Options y Informational Alarms y Unknown Alarms v Warning Alarms Y Bad Alarms lv Attach Host Configuration OK Cancel Figure 5 10 Email Settings Dialog Box 2 To enable e mail notification select the Enable Alarm Notifications over Email check box 3 In the Server box type the host name or an IP address of the SMTP server accessible on the local network In the Login box type the login information 5 In the Password box type the password SN0054651 00 F 5 23 Getting Started pad Setting the Configuration Policies QLOGIC Ce e 6 In the Email Addresses list type one or more e mail addresses to be notified Enter one e mail address for each line 7 Under Notification Options select the check boxes for the notifications that you want to send Information Alarms Unknown Alarms Warning Alarms Bad Alarms Attach Host Configuration sends the current host configuration 8 To verify that e mail notification is operable click Test If successful a message states that the e mail was sent successfully Check the e mail addresses for the e mail 9 When you finish making selections do one of the following m To save the changes and close the Email Settings dialog box click OK m To close the Email Settings dialog box without saving any changes click Cancel Setting the Configuration Policies You can
32. NG ee eee xiv Technical Support xiv AVERY k casia aa u aa vs AA xiv NG PAA oes AA xiv Contact Information XV 1 SANsurfer FC HBA Manager Overview ENVIrONMEN S 1 a MAAN AT SAGA BAGA ADA READ 1 1 AN AA AA AA 1 2 Advanced Features 1 4 2 System Overview do le Pla UA x ii i ke a ai d ai IAA AA 2 1 Single Ported Non failover Configuration 2 2 Simple Failover Configuration 2 3 SAN or Cluster Configuration 2 4 RAID Configuration and LUN Masking 2 5 Installation Checklist 2 6 Step 1 Collect the Hardware and Software 2 7 Step 2 Install the Hardware 2 9 Step 3 Install the Enhanced Driver 2 9 Step 4 Install any RAID Filter Drivers 2 10 Step 5 Install and Run SANsurfer FC HBA Manager 2 11 Step 6 Configure the Disks in the Operating System 2 12 Step 7 Install the IP Communications Driver 2 12 Non Windows Configuration Parameters 2 12 Linux Enhanced Driver Parameters 2 12 Macintosh Basic Parameters 2 12 NetWare Enhanced Driver Configuration Pa
33. Options Dialog Box Warning Displays 5 18 Options Dialog Box Configuration Change 5 19 Options Dialog Box AppEventLog 5 21 Options Dialog Box HBA Event Log 5 22 Email Settings Dialog BOX 5 23 Policy Settings Dialog BOX ssssisrisersssssnsirorsiruinunirrserras 5 25 Shared Device Found Dialog BOX 5 28 Shared Components Dialog Box 5 29 Settings Page Adapter Driver 5 30 1 SN0054651 00 F SANsurfer FC HBA Manager User s Guide pad Management Tool for QLogic FC and FCoE Adapters LOGIC aaa BB 5 15 6 1 6 2 7 1 7 2 7 3 7 4 7 5 Settings Page Linux Failover Driver Only 5 31 Transceiver Details Page General Page 6 8 Transceiver Details Page Details Page 6 10 Windows Services 7 12 Local properties File 7 15 Agent properties File 7 15 SANsurfer lax FileEkample 7 17 Command Prompt Properties Dialog BOX 7 18 SN0054
34. Path Glossary 5 pid process identifier qlremote 7 20 policies configuration 5 24 Policy Settings dialog box 5 24 port driver Glossary 2 port icons adapter 5 10 Pre Installation Summary dialog box installation 4 13 priority 1 4 process identifier pid qlremote 7 20 product information viewing 5 15 Q QL2x00 cfg file 2 13 QLogic Fast UTIL adapter BIOS utility 2 9 QLogic HBA23xx conf file 2 12 QLogic HBA23xxConfig file 2 12 QLogic SAN Interoperability Guide 3 1 qlremote agent defined 7 1 restarting 7 19 stopping 7 19 7 20 troubleshooting 7 5 7 10 QLxxxx adapters supported by SANsurfer FC HBA Manager 3 4 QoS 1 4 Glossary 5 questions and answers A 1 R RAID configuration 2 5 RAID filter driver installation 2 10 RAM requirement 3 1 read write buffer test 6 6 Red Hat Enterprise Linux connecting to hosts automatically 5 4 starting SANsurfer FC HBA Manager on 5 3 Index 5 SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters XX QLOGIC ee Refresh button updating host and adapters 5 8 refreshing the host configuration 5 32 remote procedure calls RPCs 2 11 requirements hardware 3 1 software 3 2 system 3 1 RPC service ONC RPC portmapper 2 11 S SAFTE device icons 5 11 SAN Glossary 5 SAN system configuration 2 4 SANsurfer FC HBA Manager exiting 5 12 features 1 2 installing 2 11 4 3 product information viewing 5 15 starting 5 1 uninstalling 4
35. Programs point to Accessories and then click Command Prompt b In the Command Prompt window click the upper left corner of the title bar c Onthe shortcut menu click Properties The Command Prompt Properties dialog box opens Figure 7 5 2 Command Prompt Properties x Options Font Layout Colors Window Preview m Screen Buffer Size Width feo Height s999 34 Window Size Width 80 Height fos a m Window Position Left 220 lt Top eo IV Let system position window Cancel Help Figure 7 5 Command Prompt Properties Dialog Box d Click the Layout tab to bring that page to the front e Under Screen Buffer Size click the Height box and type 9999 Click OK f On the Apply Properties To Shortcut dialog box click Modify shortcut that started this window and then click OK 5 Start SANsurfer FC HBA Manager A new console window opens that displays SANsurfer FC HBA Manager user interface activity 7 18 SN0054651 00 F XX Troubleshooting QLOGIC Tracing SANsurfer FC HBA Manager and Agent Activity Debug I 1 Exporting or Saving Agent Activity Logs This section provides information about m Agent Logs by Operating System on page 7 19 m Exporting or Saving the Agent Logs on page 7 19 Agent Logs by Operating System Agent activity automatically logs to one of the following The name and location of the log differs dep
36. QLogic Failover Enable Disable 4 15 Install SANsurfer Launch SANsurfer Application 4 16 Install SANsurfer Install Complete 4 17 Update SANsurfer Select Update Dialog Bok 4 20 Update SANsurfer Server Proxy Settings Dialog Box 4 21 Update SANsurfer Update Dialog Box 4 22 Update SANsurfer Select Update Dialog Bok 4 23 Update SANsurfer Open Dialog BOK 4 24 Update SANsurfer Update Dialog Box 4 25 Uninstall SANsurfer Add Remove Programs Windows 2000 4 27 Uninstall SANsurfer Uninstall SANsurfer 4 28 Uninstall SANsurfer Uninstall Options 4 29 Uninstall SANsurfer Choose Product Features 4 30 Uninstall SANsurfer Uninstall SANsurfer 4 31 Uninstall SANsurfer Uninstall Complete 4 32 SANSUNEr ICON Kapa Kata GL PRAAN AA KA AA RE KA KA PAD BD ee 5 2 SANsurfer FC HBA Manager Main Window 5 7 Browser Location DialogBOK 5 14 About SANsurfer FC HBA Manager Window 5 15 Sec ty PAGE iha pana aa ABAKA AA AA aan 5 17
37. Supported file formats include Comma Separated Value CSV and 8 bit Unicode Transformation Format UTF 8 text The process of archiving events occurs without user intervention as long as the Auto Archive check box is selected 4 When you finish making selections do one of the following m To save the changes and close the Options dialog box click OK m To close the Options dialog box without saving any changes click Cancel 5 22 SN0054651 00 F XX Getting Started LOGIC Setting Up Automatic Notification by E mail TO g9 9878 Setting Up Automatic Notification by E mail You can automatically send event notifications along with a copy of the current host configuration by e mail to a distribution list thus enabling the information to be opened and analyzed from other locations Adapter event notification through e mail is available only with servers running the SMTP agent NOTE For information about viewing notifications received by e mail see Viewing an Adapter Event Notification Received by E mail in the help system To set up automatic notification by e mail 1 To access the Email Settings dialog box choose one of the following options m On the SANsurfer FC HBA Manager main window open the Settings menu and then click Email E Press CTRL SHIFT M The Email Settings dialog box opens Figure 5 10 _ Enable Alarm Notifications over Email Server lt enter valid server here gt i 3
38. Tracing SANsurfer FC HBA Manager and Agent Activity Debug ls 5 Open a second terminal to start the SANsurfer FC HBA Manager user interface Connect to the host with SANsurfer FC HBA Manager 6 On the terminal you opened in Step 1 press CTRL C to stop the qlremote agent This causes the agent to clean up and terminate NOTE For a NetWare system the gl remote log is already exported SN0054651 00 F 7 21 Troubleshooting pad Tracing SANsurfer FC HBA Manager and Agent Activity Debug LOGIC AA NY Notes 7 22 SN0054651 00 F XX LOGIC The Ultimate in Performance A Frequently Asked Questions Table A 1 lists some frequently asked questions FAQs about SANsurfer FC 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 FC HBA Manager run Can the SANsurfer FC HBA Manager user interface running on Red Hat SUSE Linux talk to a Windows host running the agent What does the blinking heart on the con nected host mean Can the current contents of the alarm and event logs be saved to a file Can SANsurfer FC HBA Manager be run as a Java applet Does SANsurfer FC HBA Manager sup port SNMP The SANsurfer FC HBA Manager user interface runs on any platform that supports the Java JVM 1 4 specifica tion The agent runs only on Windows XP Profes
39. Users Profile will only add the program groups to the current user performing the IX POWERED BY All Users Profile will add the program groups to all existing users of the system install default selection C Bb Users Profle Current Users Profile installAnywhere by Macrovision Cancel Previous Next Figure 4 8 Install SANsurfer Select Shortcut Profile Windows Only SN0054651 00 F 4 11 Installing SANsurfer FC HBA Manager pad Initial Installation LOGIC AA NN Shortcuts consist of the following m The SANsurfer icon on the desktop if you select it in Step 9 m QLogic Management Suite SANsurfer and SANsurfer Uninstaller which is accessible when you click the Start button and point to Programs 8 To specify the shortcut profile choose one of the following and then click Next a If you want the SANsurfer shortcuts available to all users click All Users Profile fyou want the SANsurfer shortcuts available only to the current user click Current Users Profile default If you are installing the SANsurfer FC HBA Manager user interface on a Windows system except Windows Vista or Windows 2008 Server the Create Desktop Icon Selection dialog box opens Figure 4 9 O SANsurfer oe EX Create Desktop Icon Selection Clear the box below if you do not SANsurfer want to create a desktop kon POWERED BY XX oLocic F create desktop kon installAnywhere by Macrovision
40. a figure table or section in this guide and links to Web sites are shown in underlined blue For example U Table 9 2 lists problems related to the user interface and remote agent UU See Installation Checklist on page 3 6 Q For more information visit www qlogic com a Text in bold font indicates user interface elements such as a menu items buttons check boxes or column headings For example Q Click the Start button point to Programs point to Accessories and then click Command Prompt Q Under Notification Options select the Warning Alarms check box m Text in Courier font indicates a file name directory path or command line text For example UU To connect to a group of hosts listed in a host group file hst type SANsurfer g path and then press ENTER Q Enter the following command sh install bin m Key names and key strokes are indicated with UPPERCASE Q Press CTRL P Q Press the UP ARROW key SN0054651 00 F xiii XX QLOGIC AA NY a Text in italics indicates terms emphasis variables or document titles For example QO Fora complete listing of license agreements refer to the QLogic Software End User License Agreement Uu What are shortcut keys Qh QLA2xxx where xxx is 440 460 462 m Topic titles between quotation marks identify related topics either within this manual or in the online help which is also referred to as the help system throughout this
41. hosts to configure the device for this host only m Click Proceed with device configuration to continue configuring the device 2 Click More to view the Shared Components dialog box as in Figure 5 13 5 28 SN0054651 00 F XX Getting Started LOGIC Specifying the Adapter Driver Settings I ua Ka Shared Components x Select a sevice to view sharing hosts Shared Devices Sharing Hosts Device 20 00 00 20 37 C3 D4 49 0 0 130 sys4w2kas Device 20 00 00 20 37 C3 DC B2 01131 Device 20 00 00 20 37 C3 DE ED 0 2 132 Device 20 01 00 D0 82 00 19 F0 013 134 Figure 5 13 Shared Components Dialog Box 3 Click the shared device or LUN in the left column to view the shared hosts in the right column 4 To close the Shared Components dialog box and return to the Shared Device Found dialog box click OK 5 To close the Shared Device Found dialog box click OK When SANsurfer FC HBA Manager updates the configuration to reflect configuration changes made by another host the configuration change reloading message appears Click OK Specifying the Adapter Driver Settings NOTE If you are using the IOCTL module with inbox drivers in Red Hat 4 0 the driver settings are disabled The driver settings are also disabled if you are using sysfs supported inbox drivers with SLES 10 0 When you set adapter driver parameters specify the following m Target Display Options Indicates t
42. icon enter the following command DINSTALL DESKTOP _ICON false SN0054651 00 F 4 17 Installing SANsurfer FC HBA Manager pad Initial Installation QLOGIC ee Windows Windows stand alone installer command lines include the following m Windows To install SANsurfer FC HBA Manager interface only adapter without an agent standalone sansurfer windows install exe i silent DSILENT INSTALL SET QMSJ_G m Windows To install all user interfaces and all agents standalone sansurfer windows install exe i silent DSILENT INSTALL SET QMSJ G NT Linux Linux stand alone installer command lines include the following m Linux To install SANsurfer FC HBA Manager user interface only adapter without an agent standalone sansurfer linux install bin i silent DSILENT INSTALL SET QMSJ_G E Linux To install all user interfaces and all agents standalone sansurfer linux install bin i silent DSILENT INSTALL SET QMSJ G LA m Linux A64 To install all user interfaces and all agents standalone sansurfer linux install iab64 bin i silent DSILENT INSTALL SET QMSJ G L IA64 E Linux PPC To install all user interfaces and all agents standalone sansurfer linux install ppc bin i silent DSILENT INSTALL SET QMSJ G L PPC Solaris Solaris stand alone installer command lines include the following m Solaris To install SANsurfer FC HBA Manager user interface on
43. installation will not be affected Uninstall Specific Features Choose specific features of SANsurfer that were installed by InstallAnywhere to be uninstalled InstallAnywhere by Zero G Cancel Figure 4 24 Uninstall SANsurfer Uninstall Options Previous p 3 Use this dialog box to uninstall the entire SANsurfer tool or specific features as follows mo Click Complete Uninstall to remove all features and components of the SANsurfer tool that were installed by InstallAnywhere This will not affect files and folders created after the installation E Click Uninstall Specific Features to remove specific features of the SANsurfer tool that were installed by InstallAnywhere The Choose Product Features dialog box opens Figure 4 25 SN0054651 00 F 4 29 Installing SANsurfer FC HBA Manager IK Uninstalling SANsurfer QLOGIC Uninstall SANsurfer Choose Product Features Uncheck features that you want to uninstall Checked features will remain installed SANsurfer elas kaa i POWERED BY SANsurfer FC HBA Manager XX Q LOGIC S5ANsurfer FC Netware 5 6 x Agent A SANsurfer FC Windows Agent V Help v gt Description SANsurfer FC HBA Manager GUI used to manage Fibre Channel HBAs NOTE Remote management of this host is not possible with a GUl only install You will need an agent also to be installed in order to remotely manage this host InstallAnywhere by Macrovision Cancel Prev
44. installed To verify that the adapter driver is installed on Macintosh 1 Type the following command and then press ENTER kextstat grep QLogic 2 Verify that the QLogic adapter driver is installed SN0054651 00 F 7 11 Troubleshooting IK Verifying that qlremote is Installed and Running LOGIC ee To verify that the adapter driver is installed on Solaris SPARC x86 1 Type the following command and then press ENTER modinfo grep qla 2 The entries if they appear are the installed QLogic adapter drivers Verifying that qlremote is Installed and Running Several problems in SANsurfer FC HBA Manager can be a result of the qlremote agent not being installed loaded or running To determine if qlremote is installed and running follow the procedure for your operating system NOTE On Windows and Linux you can update the qlremote agent using SANsurfer FC HBA Manager See Updating the qlremote Agent in the help system To verify that qlremote is installed and running on Windows 1 Open the Computer Management Services window Figure 7 1 2 Verify that the QLogic Management Suite Java agent service QLManagementAgentJava is running m Computer Management of x 5 File Action View Window Help 18 x e AmE AB Am m i m Computer Management Local i System Tools i Event Viewer F QLManagementAgentJava Name a
45. instructions on how to configure and manage remote hosts Verify that the appropriate network protocol is running m The DNS or the local host file may contain an incorrect IP address for the host name Use the ping command to ping the host name and then verify that the correct IP address is translated from the name SN0054651 00 F Troubleshooting Troubleshooting Problems and Solutions XX QLOGIC ee Table 7 2 Troubleshooting User Interface and Remote Agent Issues Continued Problem Cause and Solution SANsurfer FC HBA Manager user interface cannot discon nect from a remote host SANsurfer FC HBA Manager user interface does not find or show any adapters SANsurfer FC HBA Manager user interface does not find or display any devices SANsurfer FC HBA Manager user interface reports that the adapter device driver is invalid or incorrect Unable to find SANsurfer FC HBA Manager Application Help Cause The qlremote agent service has stopped or is unable to estab lish a network link Solution E Verify that the remote host is running the qlremote agent See Veri fying that qlremote is Installed and Running on page 7 12 E Verify that you can access the remote host through the network Use the ping command to verify communication with the remote host name and IP address Cause An incorrect operating system driver is loaded or the qlremote agent is not installed Solution E Ver
46. is a trademark of JasperSoft Inc in the United States and other countries Linux is a registered trademark of Linus Torvalds Microsoft Excel Internet Explorer Windows Windows 2000 Windows Server 2003 Windows XP Professional Windows Vista and Windows Server 2008 operating systems are registered trademarks of Microsoft Corporation in the United States and other countries Netscape and Netscape Communicator are registered trademarks of Netscape Communications Corporation in the United States and other countries Novell NetWare and SUSE are registered trademarks of Novell Inc Power PC is a registered trademark of International Business Machines Corporation in the United States other countries or both QLogic the QLogic logo QLA and SANsurfer are registered trademarks of QLogic Corporation Red Hat and Enterprise Linux are registered trademarks of Red Hat Inc in the United States and other countries Sun Solaris Java JVM JavaScript JDK Java SE Development Kit and Ultra are trademarks of Sun Microsystems Inc in the United States and other countries SPARC is a registered trademark of SPARC International Inc Products bearing SPARC trademarks are based on an architecture developed by Sun Microsystems Inc Stufflt is a registered trademark of Smith Micro Software Inc VMwere is a registered trademark of VMware Inc All other brand and product names are trademarks or registered trademarks of their respective o
47. to its previous setting see Modifying the Adapter Settings Connection Options Setting in the help system Preparing for the Read Write Buffer Test The read write buffer test must be run on a device disk or tape Before running the read write buffer test verify that the adapter port is connected to at least one device by viewing the SANsurfer FC HBA Manager FC CNA HBA tree NOTE Some devices may not support Read Write Buffer commands Check with your hardware vendors or manufacturer You can run the read write test on all devices attached to the adapter port or to specific devices attached to the adapter port To prepare for the read write buffer test for all devices attached to an adapter port 1 Inthe SANsurfer FC HBA Manager FC CNA HBA tree right click an adapter port 2 Onthe shortcut menu point to Device Diagnostics and then click Enable All Devices A check mark appears next to all the device icons attached to the selected adapter port To prepare for the read write buffer test for specific devices attached to an adapter port 1 In the SANsurfer FC HBA Manager FC CNA HBA tree right click a device 2 On the shortcut menu point to Device Diagnostics and then click Enable on Device A check mark appears next to the device icon 3 Repeat for each device you want to test SN0054651 00 F 6 5 Performing Diagnostics pad Running Loopback and Read Write Buffer Diagnostic Tests QLOGIC ee Runn
48. you are installing SANsurfer FC HBA Manager on a NetWare 6 x operating system you must also install IPX SPX on the server SANsurfer FC HBA Manager runs as a client server tool with the client running on a hardware platform that supports Java and agents running on each system that has QLogic adapters If you are using SANsurfer FC HBA Manager on a host system where adapters are installed install the SANsurfer FC HBA Manager user interface on the local host If you are installing on a Red Hat SUSE Linux IA64 or Solaris SPARC x86 system also install the SANsurfer FC HBA Manager agent on the local host NOTE SANsurfer FC HBA Manager uses remote procedure calls RPCs as follows m For Windows SANsurfer FC HBA Manager automatically installs the required RPC service ONC RPC portmapper m For Linux the Linux distribution must install the appropriate RPC libraries See the Linux distribution documentation for information about installing RPC services before installing SANsurfer FC HBA Manager m For NetWare RPC support requires loading tirpc n1m and associated files The SANsurfer FC HBA Manager installation adds these files automatically to the autoexec ncf file Verification When using SANsurfer FC HBA Manager to configure any alternate paths to devices it treats these paths as unconfigured paths until it installs the Failover driver SN0054651 00 F 2 11 System Overview pad Non Windows Configuration Parameters LOGIC E B
49. 2 system requirements 3 1 T T11 Glossary 6 tape icons 5 11 target Glossary 6 target binding Glossary 6 SN0054651 00 F XX QLOGIC SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters targets binding options 5 32 display options 5 31 technical support xiv knowledge base searching 7 2 user forums searching 7 2 tests loopback 6 6 read write buffer 6 6 running 6 1 tirpc nlm file NetWare 2 11 tool event log saving from Event Viewer 7 19 toolbar buttons described 5 7 hiding from view 5 8 Topology page viewing host status 5 5 tracing tool activity 7 14 traffic signal viewing host status 5 5 transceiver details 6 7 diagnostics 6 8 6 10 troubleshooting tools 7 1 agent logs 7 19 agent logs exporting or saving 7 19 debugging user interface activity 7 14 Linux messages file 7 2 problems and solutions 7 3 Solaris SPARC messages file 7 3 Windows event log 7 1 U Uninstall Complete dialog box 4 31 uninstall instructions 4 26 Uninstall Options dialog box 4 29 Uninstall SANsurfer dialog box 4 28 4 31 Update dialog box 4 21 4 25 Update Flash utility 7 9 updating SANsurfer FC HBA Manager 4 20 updating tool by Web 4 20 updating tool package update 4 23 user forums searching 7 2 SN0054651 00 F V Video card requirements 3 2 viewing FC CNA HBA tree 5 6 help system 5 13 main window elements of 5 5 toolbar 5 8 warning messages 5 18 W warning display op
50. 22 4 23 4 24 4 25 4 26 4 27 5 1 5 3 5 4 5 5 5 6 5 7 5 8 5 10 5 11 5 12 5 13 5 14 SANsurfer FC HBA Manager User s Guide Management Tool for ALogic FC and FCoE Adapters I AA Single Ported Non failover Configuration 2 2 Simple Failover Configuration 2 3 SAN or Cluster Configuration 2 4 RAID Configuration and LUN Masking 2 5 SANsurfer Download Selections Ekample 4 4 Install SANsurfer Introduction 4 5 Install SANsurfer Important Information 4 6 Install SANsurfer Choose Product Features 4 7 Macintosh Installation Choose Product Features 4 9 Install SANsurfer Choose Install Folder 4 9 Previous SANsurfer Install Detected Message 4 10 Install SANsurfer Select Shortcut Profile Windows Only 4 11 Install SANsurfer Create Desktop Icon Selection Windows Only 4 12 Install SANsurfer Pre Installation Summary 4 13 Install SANsurfer Installing SANsurfer 4 14 Install SANsurfer Novell NetWare Disk Selection 4 14 Install SANsurfer Default
51. 651 00 F XX QLOGIC SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters Oe 2 1 Available Driver Features by Operating System 4 1 Configuration Option Installation Requirements 5 1 Traffic Signals 5 2 Toolbar Buttons 6 1 Driver Versions That Do Not Require a Loopback Connector 7 1 Troubleshooting Installation Issues 7 2 Troubleshooting User Interface and Remote Agent Issues 7 3 Troubleshooting Functional Issues A 1 Frequently Asked Questions B 1 Shortcut Keys SN0054651 00 F 2 7 4 2 5 6 5 7 6 4 7 4 7 5 7 8 A 1 B 1 SANsurfer FC HBA Manager User s Guide pad Management Tool for QLogic FC and FCoE Adapters LOGIC E S 2 SN0054651 00 F
52. A remote procedure call developed by Sun Micro systems Path A combination of an HBA port and a target port Note that this is distinct from any internal paths within the fabric network A fabric network appears to the operating system as an opaque network between the adapter initiator and the target port SN0054651 00 F Because a path is a combination of an adapter and a target port a path is distinct from another path if it is accessed through a different adapter and or it is accessing a different target port Consequently when switching from one path to another the driver might be selecting a different adapter initiator a different target port or both This makes a difference to the driver when selecting the proper method of failover notification It can make a differ ence to the target device which might have to take different actions when receiving retries of the request from another initiator or on a different port Point to point Two FC nodes directly connected non loop Port Access point in a device where a link attaches The four types of ports include m N Portis a FC device port that supports point to point topology m NL Port is a FC device port that supports loop topology m F Portisa port in a fabric where an N Port can attach m FL_Port is a port in a fabric where an NL Port can attach Qos Quality of Service Service Level Agreement SLA that ensures business continuity when trans
53. B Step 6 Configure the Disks in the Operating System After completing all hardware and configuration for FC subsystems use the appropriate operating system utilities to enable devices assign drive letters or logical names and initialize file systems for each device or LUN on the system Step 7 Install the IP Communications Driver As an option you can install the IP communications driver To use the NDIS driver to enable IP traffic over FC install that device driver and its configuration utility Non Windows Configuration Parameters This section lists specific configuration parameters for Linux Macintosh and NetWare Linux Enhanced Driver Parameters NOTE If you are using the IOCTL module with the inbox driver or if you are using sysfs IOCTL module based drivers in Red Hat 4 0 persistent configuration is not saved Additionally persistent configuration is not saved if you are using inbox drivers with SLES 10 0 QLogic configuration parameters are stored in the modules conf file in the etc subdirectory For parameter values see the readme txt file for the enhanced driver To maintain backward compatibility if it cannot read the configuration from persistent storage the enhanced driver defaults to the previous operation of configuring and enabling all devices found Some OEMs indicate that this is an unacceptable risk when adding a new host to a SAN system they would rather configure no devices instead of all devices
54. C HBA Manager E Appendix B Shortcut Keys lists keyboard combinations used to perform tasks in SANsurfer FC HBA Manager m Glossary lists common hardware software and FC terms that are used in SANsurfer FC HBA Manager In addition at the end of this guide is a index to help you easily locate information Intended Audience This guide is for system administrators who are responsible for installing configuring and managing QLogic adapters using the SANsurfer FC HBA Manager Related Materials For additional help installing or using the SANsurfer FC HBA Manager refer to the following related documents mH QLogic 2Gb 8Gb FC HBA Quick Start Guide part number FC0054505 00 a readme txt SANsurfer notes included with SANsurfer FC HBA Manager E SANsurfer FC HBA Manager Release Notes Details about the modifications since the previous version There are separate release notes based on the operating system MB QLE8042 QLE8042 SR Converged Network Adapter Installation Quick Start Guide part number FE0154501 00 xii SN0054651 00 F XX QLOGIC ls Documentation Conventions This guide uses the following documentation conventions E NOTE provides additional information mo CAUTION indicates the presence of a hazard that has the potential of causing damage to data or equipment a WARRNING indicates the presence of a hazard that has the potential of causing personal injury m Text in blue font indicates a hyperlink jump to
55. FC HBA Manager e Click Change Remove To start the SANsurfer uninstaller from a Red Hat SUSE Linux or Solaris SPARC x86 system do one of the following and then press ENTER mM Ona Red Hat SUSE Linux system if usr local bin is in the path type SANsurferUninstaller m Ona Solaris SPARC x86 system if usr bin is in the path type SANsurferUninstaller HR Ona Red Hat SUSE Linux or Solaris SPARC x86 system if neither of the preceding are in the path change to the directory where the SANsurfer tool is installed The default location is opt QLogic Corporation SANsurfer UninstallDat Type SANsurferUninstaller SN0054651 00 F 4 27 Installing SANsurfer FC HBA Manager XX Uninstalling SANsurfer LOGIC AA NY The Uninstall SANsurfer dialog box Figure 4 23 opens with SANsurfer x x as the program to be uninstalled O Uninstall SANsurfer SANsurfer XX GLOGIC Previous Figure 4 23 Uninstall SANsurfer Uninstall SANsurfer 2 Click Next to continue 4 28 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Uninstalling SANsurfer The Uninstall Options dialog box opens Figure 4 24 VW Uninstall SANsurfer Oj xj Uninstall Options Please select one of the following options SANsurfer XX OLoGiC oe lete Uninstall omplete Uninstal Completely remove all features and components of SANsurfer that were installed by InstallAnywhere Files and folders created after the
56. In Macintosh the driver layers include m Upper Layer is the device manage ment layer It handles device depen dent tasks for devices such as disks and tapes m Middle Layer is the SCSI traffic handling layer It directs requests between the kernel and the SCSI SN0054651 00 F XX QLOGIC SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters I m Lower Layer is the SCSI adapter driver It communicates directly to the SCSI adapter Echo diagnostic test Test that transmits a received signal back to the sender to verify the integrity of the device Enhanced Ethernet New enhancements to the existing Ethernet standard that eliminate Ethernet s inherently lossy nature and make 10Gb Ethernet a viable storage networking transport Also called DataCenter Ethernet or Converged Enhanced Ethernet Fabric Consists of cross connected FC devices and switches Failover path Software feature that ensures data avail ability and system reliability by assigning alternate path and automatic HBA failover for device resources This feature is avail able only in Windows 2000 Windows Server 2003 Windows Vista Novell NetWare and Red Hat SUSE Linux Windows XP and Windows Server 2008 do not support failover Fast UTIL QLogic Fast UTIL FC HBA BIOS utility FC Fibre Channel A high speed serial inter face technology that supports other higher layer protocols such as iSCSI a
57. LUNs Cause The LUN path is unconfigured Solution In the Fibre Channel Configuration dialog box set the device path to visible or hidden if a failover configuration will be saved Unable to set device pathas Cause The SANsurfer FC HBA Manager user interface or qlremote visible hidden or unconfig agent did not detect any devices ured Solution Verify that the SANsurfer FC HBA Manager user interface shows the devices under their adapters in the FC CNA HBA tree Each device should show its device port name and its connected LUNs Unable to set LUN path as Cause The LUN path is not configured or the devices were not preferred or alternate detected by the SANsurfer FC HBA Manager user interface or qlremote agent Solution Verify that the SANsurfer FC HBA Manager user interface shows the devices under their adapters in the FC CNA HBA tree Each device should show its device port name and its connected LUNs Unable to get host Informa Cause The qlremote agent is not running or installed tion Solution Verify that the qlremote agent is installed and running see Verifying that qlremote is Installed and Running on page 7 12 7 8 SN0054651 00 F XX QLOGIC Troubleshooting Troubleshooting Problems and Solutions I Table 7 3 Troubleshooting Functional Issues Continued Problem Cause and Solution Unable to display adapter Information Adapter Port Sta tist
58. Model aLazog PA Alas o Port 1 Good a HBA Model QLE258 o8 Port 1 Good Serial Number A2 o amp Port 2 Good HBA Model OLA244 o amp Port 1 Good HBA Model OLA248 amp Port 1 G00d HBA Model OLA234 gt amp Port 1 G00d FCICNA HBA Tree Driver Version o amp Port 2 Good HBA Model LE804 o amp Port 1 G00d FCoE Engine Driver Firmware Version 2 3 4 QLdirect Driver Version 9 1 8 15 STOR Miniport 9 1 8 15 QLA2300 102 10 32 QCP2330 32 Figure 5 2 SANsurfer FC HBA Manager Main Window Toolbar Buttons Tabbed Pages Status Bar The toolbar buttons in Table 5 2 provide easy access to frequently used functions Table 5 2 Toolbar Buttons Button Purpose App Events Connect if Configure Click the App Events button to open the App Events log where you can review the events that occur on your host and manage the App Events log information See Viewing and Managing the App Event Log in the help system Click the Connect button to attach the SANsurfer FC HBA Manager to a specific host or IP address See Connecting to Hosts in the help system Click the Configure button to open the Fibre Channel Port Configura tion dialog box where you can configure the adapters on your host See Configuring Fibre Channel Devices in the help system SN0054651 00 F
59. Nsurfer FC HBA Manager Security on page 5 16 Setting the Warning Display Option on page 5 18 Setting the Configuration Change Option on page 5 19 Setting Application Event Log Options on page 5 20 Setting the HBA Event Log Option on page 5 21 Setting Up Automatic Notification by E mail on page 5 23 Setting the Configuration Policies on page 5 24 Specifying the Adapter Driver Settings on page 5 29 Refreshing the Host Configuration on page 5 32 Starting SANsurfer FC HBA Manager The SANsurfer FC HBA Manager startup procedures differ depending on the operating system m Windows see page 5 2 m Red Hat SUSE Linux or Solaris SPARC x86 see page 5 3 m Macintosh OS X see page 5 3 For details about automatically connecting to specified hosts when you start SANsurfer FC HBA Manager from a command line see the SANsurfer FC HBA Manager Application Help SN0054651 00 F 5 1 Getting Started XX Starting SANsurfer FC HBA Manager LOGIC aaa BB Starting SANsurfer FC HBA Manager on Windows NOTE If you want to connect to one or more specified hosts automatically when starting SANsurfer FC HBA Manager see Connecting to Hosts Automatically Windows CLI on page 5 3 On a Windows system do one of the following to start the SANsurfer tool which includes the SANsurfer FC HBA Manager user interface To start SANsurfer FC HBA Manager on Windows m Double click the SANsurfer icon F
60. Setting the HBA Event Log Option 5 21 Setting Up Automatic Notification by E mail 5 23 Setting the Configuration Policies 5 24 Forbidden Sharing of Devices or LUNS 5 28 Specifying the Adapter Driver Settings 5 29 Refreshing the Host Configuration 5 32 6 Performing Diagnostics Running Loopback and Read Write Buffer Diagnostic Tests 6 1 Preparing for Diagnostic Testing 6 2 Finding the Adapter Port You Want to Test 6 2 Preparing for the Loopback Test 6 3 Preparing for the Read Write Buffer Test 6 5 Running the Loopback Test 6 6 Running the Read Write Buffer Test 6 6 Viewing Adapter Port Transceiver Details 6 7 General Page III ewe ee os Chae eed 6 8 Media Information 6 8 Diagnostic Data 6 9 Details AA KAA ounce AA AA bare 6 10 7 Troubleshooting Troubleshooting Tools 7 1 Windows EventLog 7 1 Linux Messages File 7 2 Solaris Messages File 7 3 SANsurfer FC HBA Manager
61. U Linux a Red Hat RHEL AS ES 5 0 32 bit 64 bit Intel 1A64 Intel 64 AMD64 E Red Hat RHEL AS ES 4 5 32 bit 64 bit Intel 1A64 Intel 64 AMD64 H Red Hat RHEL AS ES 4 0 32 bit 64 bit Intel IA64 Intel 64 AMD64 E Red Hat RHEL AS ES 3 0 32 bit 64 bit Intel x86 Intel 64 AMD64 m Novell SLES 10 32 bit 64 bit Intel IA64 Intel 64 AMD64 m Novell SLES 9 32 bit 64 bit Intel IA64 Intel 64 AMD64 m Novell SLES 8 32 bit 64 bit Intel x86 AMD64 CU VMware ESX a ESX 3 5 32 bit Intel 64 AMD64 NOTE For specific OS service packs SPs and updates refer to the descriptions where this tool version is posted on the QLogic Web site http support qlogic com support drivers_software aspx SN0054651 00 F 3 3 System Requirements Supported QLogic Adapters XX QLOGIC ee Supported QLogic Adapters The following supported QLogic adapters are collectively referred to as the QLA2xxx adapters throughout this guide unless otherwise noted QEM2462 QLA200 QLA210 QLA2310 QLA2310F QLA2340 QLA2342 QLA2344 QLA2344 P QLA2440 QLA2460 QLA2462 QLE220 QLE2360 QLE2362 QLE2440 QLE2460 QLE2462 QLE2464 QLE2540 QLE2560 QLE2562 QLE2564 QLE8042 QSB2340 QLE2562 SN0054651 00 F XX LOGIC The Ultimate in Performance 4 Installing SANsurfer FC HBA Manager Installing SANsurfer FC HBA Manager consists of installing the SANsurfer FC HBA Manager user interface a platform specific agent
62. XX OLOGIC The Ultimate in Performance SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters SN0054651 00 F SANsurfer FC HBA Manager User s Guide pad Management Tool for QLogic FC and FCoE Adapters QLOGIC ee 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 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 QLogic Corporation assumes no responsibility for any errors that may appear in this document Apple Mac OS Macintosh and Power Mac are registered trademarks and Finder Tiger Leopard and Safari are trademarks of Apple Inc registered in the U S and other countries EMC and CLARiiON are registered trademarks of EMC Corporation Firefox is a registered trademark of the Mozilla Foundation InstallAnywhere and the InstallAnywhere logo are trademarks or registered trademarks of Zero G Software Inc Intel and Pentium are trademarks of Intel Corporation in the U S and other countries JasperReports
63. _Physical Address This is a low level address on the FC loop Arbitrated loop A non point to point circular topology that connects two or more ports but only two ports can communicate at one time The network passes all communication through all ports connected onto the loop BIOS Basic Input Output System An HBA s flash PROM contains the code that allows booting from the HBA at startup Boot code The first program to run when a system is powered on This is also true for devices within a system such as FC HBAs FCode BIOS and EFI enhanced firmware interface are all forms of boot code for specific hardware operating system environments Boot code for QLogic FC adapters is required if the computer system is booting from a storage device boot device attached to the QLogic adapter SN0054651 00 F XX LOGIC The Ultimate in Performance The primary function of the boot code is communication with the external boot device before the operating system is up and running The boot code can also perform secondary functions including managing the setup for the adapter and initializing and testing the adapter s ISP Boot device The hard disk that contains the operating system that the BIOS uses to boot from when the computer is started CNA Converged Network Adapter CNAs support both data networking TCP IP and storage networking FC traffic on a single I O adapter using two new technolo gies Enha
64. allocate up to 80 of the number of gigabytes per second Gbps transmission speed of the physical port s capacity to its defined virtual ports NPIV Using this feature lets you guarantee a transmission rate for each port that requires a particular bandwidth to run mission critical applications for business continuity using virtual ports The setting for a given QoS can resolve bottlenecks that exist when Virtual Machines contend for port bandwidth m Setting the QoS by priority lets you set the priority level for the physical port as well as its defined virtual ports This enables to you give preference to data transmissions for one virtual port over others by giving it a higher priority than the others You can set the priority level on any port regardless of the settings applied to other ports SN0054651 00 F XX LOGIC The Ultimate in Performance 2 System Overview SANsurfer FC HBA Manager is a collection of device drivers and management tools for configuring and managing QLogic FC and FCoE adapters in a SAN This section provides the following information m Configurations on page 2 1 shows examples of several different configurations g Installation Checklist on page 2 6 contains a checklist to help you properly install all hardware and software in the correct order m Non Windows Configuration Parameters on page 2 12 lists configuration and tuning parameters This information is intended for OEM
65. alog Box The available update information includes E Current Updates column lists product updates available for the current program version E Selected Updates column lists product updates that you select for installation 4 To use the Update dialog box select the current product update packages m o select a package select its entry in the Current Updates list and then click Add gt gt The update moves to the Selected Updates list E To remove a package in the Selected Updates list select it and click lt lt Remove The selected package returns to the Current Updates list For each update selected the following information is shown m Status describes the current status of the selected update m Size indicates the size of the selected update in MBs HR Description provides a general description of the update SN0054651 00 F 4 25 Installing SANsurfer FC HBA Manager pad Uninstalling SANsurfer QLOGIC 5 When you finish selecting updates click Update to start the download and installation process Follow the instructions to install the selected product update Or to discontinue the update process and stop the installation click Cancel Uninstalling SANsurfer Perform the following steps to uninstall from this system either the entire SANsurfer management toolset including SANsurfer FC HBA Manager or specific features Be sure to exit all SANsurfer tools before you uninstall any SANsurfer tools NOTES m Wh
66. ancel Previous Next Figure 4 14 Install SANsurfer Launch SANsurfer Application 13 To automatically start SANsurfer FC HBA Manager when installation is complete select the Launch Application check box and then click Next To start the tool later clear the check box and then click Next The Install Complete dialog box appears Figure 4 15 4 16 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Initial Installation I aaa O SANsurfer Me xj Install Complete Congratulations The installabon is complete Press Done to quit the Installer SANsurfer POWERED BY SANsurfer has been successfully installed to CAProgram FilestQLogic XKX OLOGIC Corporation SANsurfer installAnywhere by Macrovision Da Previous Done Figure 4 15 Install SANsurfer Install Complete 14 To exit the installer click Done Now you are ready to customize SANsurfer FC HBA Manager and set your security parameters see Getting Started on page 5 1 Installation Instructions Using CLI SANsurfer provides the ability to install the tool and its components using a command line interface CLI This section lists the commands for Windows Linux and Solaris stand alone installation options NOTES m To change the destination folder add the D parameter to the command lines as follows DUSER INSTALL DIR d Apps SANsurfer you may need to escape the here m To prevent installation of the desktop
67. and help components as appropriate NOTE Before installing SANsurfer FC HBA Manager read and follow the instructions in the documents listed in Related Documents on page 1 4 as applicable This section provides the following information HO Initial Installation on page 4 1 H Web and CD Based Installation Updates on page 4 20 m Uninstalling SANsurfer on page 4 26 Initial Installation You can install the SANsurfer tool which includes SANsurfer FC HBA Manager using the management tools from the QLogic Web site m Be sure to install the same version of the SANsurfer tool on all systems in the network m Optional If you have a previous version of SANsurfer FC HBA Manager uninstall these tools before installing SANsurfer FC HBA Manager On a JS20 or JS21 blade that has a previous version of SANsurfer FC HBA Manager installed ensure that the previous version of SANsurfer has been completely uninstalled before installing this new version If you attempt to re install this update prior to uninstalling a previous version the system prompts you to remove the current tool If the display has been exported using the DISPLAY method a hidden window with no focus appears behind the main installation window The installer appears to hang however it is waiting for an action to be taken on the hidden window SN0054651 00 F 4 1 Installing SANsurfer FC HBA Manager Initial Installation XX QLOGIC Ce
68. arget port ID changes this target is considered a newly added target all existing persistent data is deleted and specific features disabled 5 Click Save to preserve these adapter driver settings Refreshing the Host Configuration The host configuration including the FC CNA HBA tree shown in the SANsurfer FC HBA Manager interface refreshes automatically based on the polling interval If you want to refresh the configuration immediately you changed the configuration for example choose one of the following options E On the toolbar click the Refresh button m On the SANsurfer FC HBA Manager main window open the Host menu and then click Refresh Right click the FC CNA HBA tree and on the shortcut menu click Refresh Press F5 5 32 SN0054651 00 F XX LOGIC The Ultimate in Performance 6 Performing Diagnostics SANsurfer FC HBA Manager provides end to end diagnostics that allow you to test adapters and the devices to which they are connected Diagnostic tests include the following m The external loopback test which evaluates the ports transmit and receive transceivers on the adapter and the error rate a 10 bit internal or 1 bit serial internal loopback test available on 8Gb adapters such as the QLE256x a The read write buffer test verifies the link between the adapter and its attached devices This section contains the following diagnostic procedures m Running Loopback and Read Write Buffer Dia
69. as described for Windows installations See Initial Installation on page 4 1 Start the FC HBA Manager on the Windows system and connect to the remote VMware ESX server See Starting SANsurfer FC HBA Manager on Windows on page 5 2 NOTE For supported Windows servers see Software Requirements on page 3 2 4 19 Installing SANsurfer FC HBA Manager IK Web and CD Based Installation Updates LOGIC E Web and CD Based Installation Updates To always keep SANsurfer FC HBA Manager up to date with the latest version SANsurfer provides two possible ways to update an existing installation m You can download and install an update directly from the Web m You can browse to an existing update package on some form of external media for example a CD ROM DVD or other portable storage This section provides the steps for both update methods E Updating SANsurfer by Web Update on page 4 20 E Updating SANsurfer by Package Update on page 4 23 NOTE Using SANsurfer FC HBA Manager s Web update feature requires an Internet connection because it downloads files from the QLogic Web site Updating SANsurfer by Web Update Obtain SANsurfer updates from the QLogic Web site or from service personnel CAUTION You must exit SANsurfer to avoid locked files during the update process To check for tool updates 1 On the SANsurfer FC HBA Manager main menu select Help and then click Check for Update
70. ay not require all steps Step 1 Collect the Hardware and Software Step 2 Install the Hardware Step 3 Install the Enhanced Driver Step 4 Install any RAID Filter Drivers Step 5 Install and Run SANsurfer FC HBA Manager Step 6 Configure the Disks in the Operating System Step 7 Install the IP Communications Driver 2 6 SN0054651 00 F XX System Overview QLOGIC Installation Checklist ls Step 1 Collect the Hardware and Software Collect the required hardware and software as listed in these sections Required Hardware Collect the required hardware see also Hardware Requirements on page 3 1 In all cases some combination of the following is required m QLogic Fibre Channel adapters and converged network adpters m Target devices such as disks and RAID subsystems Tape devices appear as part of the configuration but SANsurfer only supports LUN masking and diagnostics on them E Connectivity hardware such as cables hubs and fabric switches Required Software Collect the required software see also Software Requirements on page 3 2 Table 2 1 lists QLogic software products required for the features you want to enable Table 2 1 Available Driver Features by Operating System Windows Linux Windows Solaris Mac VMware Solaris NetWare Mac VMware SANsurfer FC HBA Manager Function Inbox Driver Inbox Driver Basic operation x gt lt IBILI x gt lt Enhanced Driver x Sc
71. bar tabbed pages and a status line The toolbar conveniently provides buttons for commonly used functionality The FC CNA HBA tree lists all hosts including IP addresses with their connected adapters ports devices and LUNs When you click an item in the adapter tree the status line shows additional information about the selection When you hold your cursor over an adapter in the FC CNA HBA tree for a few seconds information about the adapter model appears The FC CNA HBA tree contains icons and text as visual indicators for the hosts adapters ports devices and LUNs To view the SANsurfer FC HBA Manager main window 1 In the left frame of the main window click the FC CNA HBA tab SANsurfer FC HBA Manager shows in the title bar 2 Connect to the host for details see the SANsurfer FC HBA Manager Application Help The SANsurfer FC HBA Manager main window opens Figure 5 2 shows the elements contained on the main window 5 6 SN0054651 00 F XX QLOGIC Getting Started SANsurfer FC HBA Manager Main Window Title Bar Menu Bar SANsurfer FC HBA Manager File Host View Settings Wizards Help oOo ir a TO ku B Connect Configure App Events HBA Events Collect Monitor Diags Refresh Toolbar QLOGIC FCICNA HBA Information Settings SAN Good 2 80 Hostname n7112av87y 9 HBA Model QLA23 Hostname HBA Model QLA2300 2310 General Information n7112av87wh9g1 172 17 161 152 m HHBA
72. ch tool accepts Boolean expressions Such as AND OR and NOT as well as nested expressions It also accepts exact strings entered between quotation marks It does not support wild cards m To view help related to a specific wizard screen click the Help button located at the lower right corner of the dialog box The appropriate topic opens in a separate window To view the navigation pane click the Show button located in the top right corner of the topic pane The page replaces the Show button with a Hide button which you can click to close the navigation pane without closing the topic window SN0054651 00 F 5 13 Getting Started pad Getting Help LOGIC ee Specifying the Help Browser Follow these steps to specify the Web browser Internet Explorer or Firefox for example that SANsurfer FC HBA Manager launches when you open the help system see Viewing the Help System on page 5 13 To specify a browser 1 On the SANsurfer FC HBA Manager main window open the Help menu and then click Set Browser Location The Browser Location dialog box opens Figure 5 3 E3 Browser Location Browser Location n Files Internet ExplorerlEXPLORE EXE Browse Cancel Figure 5 3 Browser Location Dialog Box 2 In the Browser Location box type the location of the browser program file Be sure to specify the path and file name If you do not know the location click Browse to open a file selection dialog box and select the br
73. click OK Q TO disable this policy for this instance click Cancel Q To view which LUNs are being shared with hosts that are conflicting with this policy click More Ask these options when a LUN is enabled and sharing is detected If you select this policy and sharing is detected the Shared Device Found dialog box opens Figure 5 12 Click one of the following options QO Donot configure device Uu Configure and disable access from other hosts SN0054651 00 F 5 27 Getting Started XX Setting the Configuration Policies LOGIC AA NY Q Proceed with LUN configuration To accept your selection click OK To close the Shared Device Found dialog box without configuring the device click Cancel 4 To save your settings and close the Policy Settings dialog box click OK Forbidden Sharing of Devices or LUNs If you set a policy in which the sharing of devices or LUNs among hosts is not permitted and SANsurfer FC HBA Manager detects sharing the Shared Device Found dialog box opens Figure 5 12 F3 shared Device Found x Do not configure device Configure and disable access from other hosts Proceed with device configuration OK Cancel More Figure 5 12 Shared Device Found Dialog Box To configure shared devices 1 Select one of the following options mo Click Do not configure device to prevent device configuration Click Configure and disable access from other
74. close the Options dialog box without saving any changes click Cancel Setting the HBA Event Log Option Follow these steps to set the number of events the HBA Event Log can list NOTE For information about viewing the HBA Event Log see Viewing and Managing the HBA Event Log in the help system To set HBA Event Log options 1 To access the Options dialog box choose one of the following methods m Onthe SANsurfer FC HBA Manager main window open the Settings menu and then click Options SN0054651 00 F 5 21 Getting Started pad Setting the HBA Event Log Option QLOGIC TE mo Right click the FC CNA HBA tree and then on the shortcut menu click Options m Press CTRL SHIFT T The Options dialog box opens Figure 5 9 HBA Event Log The size of the HBA event log can be set from 20 to 200 events Log Size 1200 MI Auto Archive Figure 5 9 Options Dialog Box HBA Event Log 2 Under HBA Event Log type the number of adapter events the HBA Event Log can list in Log Size box The range is 20 to 200 events the default is 200 events 3 To automatically export the HBA Event Logs for archiving select the Auto Archive check box Auto Archive specifies that when the HBA event log is full it is exported to the Applications folder as a file named event _hba_archive txt The text file is an open ended file that is appended to when the HBA event log size is reached one entry at a time with the oldest entry first
75. ctivity Debug B SANsurfer lax WordPad Iof x File Edit View Insert Format Help pela SIR al e B LAX ROOT INSTALL DIR path to the installdir magic folder lax root install dir C Program Files QLogic Corporation SaNsurfer LAX STDERR REDIRECT leave blank for no output console to send to a console window and any path to a file to save to a file lax stderr redirect LAX STDIN REDIRECT leave blank for no input console to read from the console window and any path to a file to read from that file lax stdin redirect LAX STDOUT REDIRECT leave blank for no output console to send to a console window and any any path to a file to save to a file lax stdout redirect LAX USER DIR left blank this property will cause the native launcher to not alter the platform default behavior for setting the user dir To override this you may set this property to a relative or absolute path Relative paths are relative to the launcher lax user dir LAX VERSION version of Launchinywhere that created this properties file lax version 4 5 For Help press F1 Figure 7 4 SANsurfer lax File Example SN0054651 00 F 7 17 Troubleshooting IK Tracing SANsurfer FC HBA Manager and Agent Activity Debug LOGIC EE 4 Ifyou are using a Windows system follow these steps to change the height of the screen buffer a Onthe Windows Start menu point to
76. d to a switch make sure the Connection Options setting is 1 Point to Point Only See Adapter Parameters in the help system for information about viewing and modifying the setting 4 Prepare for normal operations see Preparing for Normal Adapter Operations on page 6 4 Installing a Loopback Connector Before running the loopback test you must install a loopback connector on the adapter port Note the following about the loopback connector E The loopback connector must be appropriate for the type of FC adapter connector H Be sure to select the appropriate adapter connector for testing Each adapter connector appears in the SANsurfer FC HBA Manager main window FC CNA HBA tree as an adapter port NOTE Installing the connector stops normal adapter operations To install a loopback connector 1 Disconnect the cable from the appropriate adapter connector 2 Install the loopback connector on the adapter connector Preparing for Normal Adapter Operations When you complete loopback testing follow these steps to resume normal adapter operations 6 4 SN0054651 00 F XX Performing Diagnostics LOGIC Running Loopback and Read Write Buffer Diagnostic Tests I aaa To resume normal adapter operations 1 Remove the loopback connector from the adapter connector 2 Reconnect the cable that you disconnected in Installing a Loopback Connector on page 6 4 3 Modify the adapter settings Connection Options back
77. d tool updates 4 23 change options setting 5 19 Choose Install Folder dialog box installation 4 9 4 10 Choose Product Features dialog box installation 4 7 Choose Product Features dialog box uninstall options 4 29 class driver Glossary 2 CLI installation 4 17 closing SANsurfer FC HBA Manager 5 12 cluster system configuration 2 4 2 5 CNA Glossary 1 Collect button saving files 5 8 Command Prompt Properties dialog box 7 18 configuration change option setting 5 19 Index 1 SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters XX QLOGIC ee configuration parameters See driver parameters configurations cluster system configuration 2 4 disk 2 12 examples of 2 1 networked 4 2 policies setting 5 24 RAID and LUN masking 2 5 refreshing 5 32 SAN or cluster 2 4 simple failover 2 3 single ported system configuration non failover 2 2 stand alone 4 2 system 2 1 Configure button configuring adapters 5 7 Connect button attaching to host or IP address 5 7 connecting to hosts automatically Linux Solaris or Macintosh 5 4 Windows 5 3 contents help system 5 13 conventions xiii CRC Glossary 1 Create Desktop Icon Selection dialog box installation 4 12 CSV file Glossary 1 Current Path dialog box 7 10 D DCBX Glossary 1 DDMI Digital Diagnostics Monitoring Interface 6 7 debugging user interface activity 7 14 Default Failover Enable Disable dialog box installati
78. document License Agreements Refer to the QLogic Software End User License Agreement for a complete listing of all license agreements affecting this product Technical Support 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 Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates Availability QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays Training QLogic offers training for technical professionals for all iSCSI InfiniBand and Fibre Channel products From the main QLogic web page at www qlogic com click the Education and Resources tab at the top then click the Education amp Training tab on the left The QLogic Global Training Portal offers online courses certification exams and scheduling of in person training Technical Certification courses include installation maintenance and troubleshooting QLogic SAN products Upon demonstrating knowledge using live equipment QLogic awards a certificate identifying the student as a Certified Professional The training professionals at QLogic may be reached by e mail at training qlogic com xiv SN0054651 00 F XX QLOGIC I aaa Contact I
79. e The tape icons are i Disk Online Diag Enabled tS Tape Diag Enabled Disk Online Diag Disabled Tape Diag Disabled BA Disk Inactive Diag Enabled i Tape Inactive Diag Enabled Disk Inactive Diag Disabled Tape Inactive Diag Disabled amp Offline Disk on offline host o Offline Tape on offline host The SAFTE device icons are EB SAFTE device EB Offline SAFTE device on offline host SN0054651 00 F 5 11 Getting Started IK Exiting SANsurfer FC HBA Manager QLOGIC ee LUN Icons and Text The FC CNA HBA tree indicates the LUN number LUN n For example 5 LUN 0 LUN icons indicate the following DJ LUN online 3 LUN on offline host Exiting SANsurfer FC HBA Manager To exit the SANsurfer FC HBA Manager user interface choose one of the following options m On the SANsurfer FC HBA Manager main window open the File menu and then click Exit m On the SANsurfer FC HBA Manager main window click the Close button ag in the upper right corner m Press ALT X Getting Help This section provides information about mg Viewing the Help System on page 5 13 E Specifying the Help Browser on page 5 14 m Viewing SANsurfer FC HBA Manager Tool Information on page 5 15 5 12 SN0054651 00 F XX Getting Started LOGIC Getting Help aang Viewing the Help System You can view the application online help for the SANsurfer FC HBA Manager at any time using one of the following methods m To view the a
80. e Buffer Test 6 6 The read write buffer test sends specified data through the SCSI Write Buffer command to a target device disk or tape It then reads the data back through the SCSI Read Buffer command and compares the data for errors The test also compares the link status of the device before and after the read write buffer test If errors occur the test indicates a broken or unreliable link between the adapter port and the device NOTE Link status is disabled if you are using inbox drivers with SLES 10 0 SN0054651 00 F XX QLOGIC Performing Diagnostics Viewing Adapter Port Transceiver Details ls To run a read write buffer test 1 2 Prepare for the test see Preparing for Diagnostic Testing on page 6 2 Set the diagnostic test parameters see Setting the Diagnostic Test Parameters in the help system Run the diagnostic test see Running Diagnostic Tests in the help system View the diagnostic test results see Viewing the Diagnostic Test Results in the help system NOTE The read write buffer test must be run without the loopback connector on a device disk or tape that supports the SCSI Read Buffer and SCSI Write Buffer commands Viewing Adapter Port Transceiver Details The Transceiver Details page located within the Diagnostics page shows the Digital Diagnostics Monitoring Interface DDMI for optical transceivers allowing access to device o
81. ed OK Cancel Figure 5 11 Policy Settings Dialog Box 2 Device sharing checking occurs each time a configuration change is made to a device Under Options for sharing devices among host s complete the following m To disable device sharing checking clear the Check for shared devices targets among host s check box m To enable device sharing checking select the Check for shared devices targets among host s check box and then select one of the following policies QO Do not allow selected device to be configured no device sharing allowed This policy does not allow the selected device to be configured If you select this policy and this type of sharing is detected a warning appears Do one of the following J For your system to unconfigure or not configure the device click OK Q To view which devices are being shared with hosts that are conflicting with this policy click More U Configure the selected device s and disable access from other hosts This policy configures the selected device and disables access to the device from other hosts SN0054651 00 F 5 25 Getting Started pad Setting the Configuration Policies QLOGIC ee If you select this policy and this type of sharing is detected a warning appears Do one of the following L To disable access to these devices from other hosts that display in the FC CNA HBA tree click OK Q To disable this policy for this instance clic
82. ending on the type of operating system m Windows Use the Event Viewer Red Hat SUSE Linux var log messages Macintosh Use the Utilities console application Solaris SPARC x86 var log syslog NetWare sys etc qlremote log Exporting or Saving the Agent Logs From a Windows system follow these steps to save the current tool log from the Event Viewer To save the log from the Event Viewer on Windows 1 Click the Start button point to Programs point to Administrative Tools and then click Event Viewer 2 Onthe Log menu select Save As Save the file using an appropriate name From a Red Hat SUSE Linux or Macintosh system follow the steps below to export agent activity To export agent activity on Linux or Macintosh 1 Open a terminal for example xterm Or eterm 2 top the currently running qlremote agent killall TERM qlremote 3 Inthe agent properties file add the following line node agent quiet mode enable 1 4 Start the agent again without forking into the background Redirect the stdout and stderr properties to a file see Tracing SANsurfer FC HBA Manager User Interface Activity Step 3 Send the file to your authorized service provider For Red Hat SUSE Linux usr local bin qlremote gt AgentOutput txt 2 gt amp 1 SN0054651 00 F 7 19 Troubleshooting pad Tracing SANsurfer FC HBA Manager and Agent Activity Debug LOGIC a Se For Macintosh installation folder q
83. er parameters 2 12 LIP Glossary 4 load balancing Glossary 4 local properties file 7 14 loopback Glossary 4 connector installing 6 4 test running 6 6 LUN Glossary 4 LUNs icons and text 5 12 sharing policy setting 5 24 Macintosh connecting to hosts automatically 5 4 driver parameters 2 12 starting SANsurfer FC HBA Manager on 5 3 main window 5 5 SN0054651 00 F XX QLOGIC SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters Oe media Glossary 4 memory requirement 3 1 messages file Linux 7 2 Solaris SPARC x86 7 3 miniport driver Glossary 2 miniport driver error logging 7 2 modules conf file 2 12 Monitor button viewing adapter statistics 5 8 monolithic driver Glossary 2 N NetWare driver parameters 2 13 networked configuration 4 2 nexus drivers Glossary 2 NIC Glossary 5 Novell NetWare Disk Selection dialog box installation 4 14 4 15 NPIV Glossary 5 NVRAM Glossary 5 O offline host icon 5 9 ONC Glossary 5 online host icon 5 9 Open dialog box 4 24 operating systems requirements 3 2 service packs and updates 3 3 Options dialog box application event log setting 5 21 configuration changes 5 19 configuration changes setting 5 19 HBA event log setting 5 22 warning displays enabling 5 18 OS service packs SP and updates 3 3 Overview SANsurfer FC HBA Manager 1 1 system 2 1 SN0054651 00 F P password default 5 16 reguirement for setting 5 16
84. esh button to force a manual refresh Verify that the FC CNA HBA tree shows the appropriate device port name and LUN information When change the current Cause The qlremote agent is unable to detect or communicate with path in the Current Path dia the devices log box the FC CNA HBA Solution t t te ree vee not update E Verify that the devices are online and operational Verify that the operating system driver detects and communicates with the devices Click the Refresh button to force a manual refresh Verify that the FC CNA HBA tree shows the appropriate device port name and LUN information m The DNS or the local host file may contain an incorrect IP address for the host name Use the ping command to ping the host name and then verify that the correct IP address is translated from the name Verifying that the Adapter Driver is Installed If SANsurfer FC HBA Manager is having trouble connecting to the local host follow the procedure for your operating system to verify that the adapter driver is installed If the adapter driver is not installed then install it see the SANsurfer FC HBA Manager Application Help or the QLogic Quick Start Guide If you determine that the adapter driver is installed then consider the following E ftyping the host name in the Connect to Host dialog box verify that you are typing the correct name Refer to the system server information to check the system name On the Connect to Host d
85. ess ENTER SANsurfer 1 the letter Z for local m To connect to a single host type the following and then press ENTER SANsurfer h hostname hostname is the host name or IP address For example SANsurfer h adsw2ksys2 m To connect to a group of hosts listed in a host group file hst type the following and then press ENTER SANsurfer g path pathis the path of the host group file For example SANsurfer g c Program Files QLogic Corporation SANsurfer hostfiles groupl hst Connecting to Hosts Automatically Linux Solaris or Macintosh CLI On a Red Hat SUSE Linux Solaris SPARC x86 or Macintosh system follow these steps to connect automatically to specified hosts when starting the SANsurfer FC HBA Manager user interface from the command line When done the SANsurfer FC HBA Manager main window opens with the specified hosts To connect to a host automatically on Linux Solaris or Macintosh 1 Ensure that you are in a graphical user environment 2 Opena command terminal 3 Change to the directory where the SANsurfer tool is installed NOTE On Macintosh navigate to the following additional path SANsurfer app Contents MacOS 4 Doone of the following 5 4 SN0054651 00 F XX Getting Started LOGIC SANsurfer FC HBA Manager Main Window ls HR To connect to the local host type the following and then press ENTER SANsurfer 1 the letter IL for local m To connect to a single host at startup type the f
86. fer FC HBA Manager is managing several hosts and a remote host reboots or there is activity in the SAN the qlremote agent and SANsurfer FC HBA Manager refresh the configuration to ensure that no adapter or device was disconnected SN0054651 00 F 7 7 Troubleshooting pad Troubleshooting Problems and Solutions LOGIC AA NY Functional Issues Table 7 3 lists functional problems that may occur with using SANsurfer FC HBA Manager and provides possible causes and solutions Table 7 3 Troubleshooting Functional Issues Problem Cause and Solution Unable to create failover con Cause An incorrect version of SANsurfer FC HBA Manager is installed figuration or SANsurfer FC HBA Manager detected an invalid configuration Solution To create a failover configuration the following criteria must be met m The host system must contain two or more adapters m The storage subsystem must report the same device node name and separate device port names for each port m The storage subsystem must report the same total number of LUNs down each path m The storage subsystem must report the same LUN numbers for each port Unable to create load bal Cause SANsurfer FC HBA Manager detected an invalid configuration ance configuration Solution To enable load balancing each storage subsystem must report multiple LUNs When using a JBOD you must individually con figure and manually balance each device Unable to mask
87. fer FC Solaris Agent E SANsurfer Mac OS X FC Agent 4 2 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Initial Installation TO mrrr rr Installation Instructions The SANsurfer installer is a self extracting utility that installs SANsurfer FC HBA Manager and related files NOTE If you are installing SANsurfer on a Macintosh download the Stufflt file and expand the contents After the contents are expanded double click the Install icon using the Finder If the utility is already installed you may want to perform routine Web CD based updates If you are installing the SANsurfer FC HBA Manager agent on a NetWare server note the following m You cannot install the SANsurfer FC HBA Manager agent directly on a NetWare server you must install the agent from a Windows system connected to the NetWare server m The prerequisites for each NetWare server are as follows Q A Windows system must be connected to the NetWare server through the TCP IP network Q The Windows system must have a drive mapped to the NetWare server system volume sys Perform the following steps to install SANsurfer FC HBA Manager on your system or on the NetWare server connected to this system SN0054651 00 F 4 3 Installing SANsurfer FC HBA Manager pad Initial Installation QLOGIC Ce To install SANsurfer FC HBA Manager 1 Download the application from the QLogic Web site a Onthe QLogic home page http www ql
88. following m To have SANsurfer FC HBA Manager automatically update to the new configuration click Apply Configuration Changes Automatically If another host has made configuration changes that need to be updated in this configuration a message appears stating Would you like to refresh the Configuration for Hostname lt hostname ip address gt Click OK sf you want to decide whether to update to the new configuration click Confirm Configuration Change Applies SN0054651 00 F 5 19 Getting Started pad Setting Application Event Log Options QLOGIC E Se If a configuration change occurs a message appears stating Would you like to refresh the Configuration for Hostname lt hostname ip address gt Doone of the following Q To refresh the configuration click Yes LJ To not update to the new configuration click No The old configuration remains unchanged To update to the current configuration manually connect and disconnect the host E If you want to ignore the configuration change click Ignore Configuration Changes The old configuration remains unchanged To update to the current configuration manually connect and disconnect the host NOTE Selecting Ignore Configuration Changes disables the Refresh button on the main window 3 When you finish making selections do one of the following m To save the changes and close the Options dialog box click OK m o close the Options dialog box without
89. g the toolbar 5 8 Index 3 SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters XX QLOGIC eo host configuration refreshing 5 32 connecting to automatically 5 3 5 4 events viewing 5 7 5 8 icons meaning of 5 9 status 5 9 status viewing Topology page 5 5 host group file hst 5 4 5 5 icons 5 9 adapter 5 10 device 5 11 disk 5 11 LUN 5 12 SAFTE device 5 11 tape 5 11 Important Information dialog box installation 4 6 inbox driver NetWare 2 12 index help system 5 13 Install Complete dialog box installation 4 16 installation 4 1 checklist 2 6 CLI 4 17 configure disks 2 12 install enhanced driver 2 9 install hardware 2 9 install IP communications driver 2 12 install RAID filter drivers 2 10 install SANsurfer FC HBA manager 2 11 instructions 4 3 required hardware 2 7 required software 2 7 Installing SANsurfer dialog box installation 4 13 installing updates from update package 4 23 Internet Protocol Glossary 4 Introduction dialog box installation 4 5 IOCB Glossary 4 loctl Glossary 4 IOCTL module 2 12 Index 4 IP communications driver installation 2 12 iSCSI Glossary 4 ISP Glossary 4 J Java Web Start updating SANsurfer FC HBA Manager 1 2 JBOD Glossary 4 JNLP Glossary 4 K keyboard shortcuts B 1 knowledge base searching 7 2 L Launch SANsurfer Application dialog box installation 4 16 layers Glossary 2 leaf drivers Glossary 2 Linux driv
90. ge 4 1 Uninstalling SAN surfer on page 4 26 Installation Instructions on page 4 3 Toolbar Buttons on page 5 7 Adapter Icons and Text on page 5 9 Specifying the Adapter Driver Settings on page 5 29 6 Performing Diagnostics Finding the Adapter Port You Want to Test on page 6 2 Added definitions of CNA Enhanced Ethernet and Glossary FCoE Revision C changes Added note on downloading service packs from page 1 2 the website Added descriptions of advanced features Updated Available Driver Features by Operating System Moved wrongly placed NOTE from NetWare to Linux topic Advanced Features on page 1 4 Table 2 1 page 2 12 SN0054651 00 F SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters XX QLOGIC ee Removed all references to QLdirect Changed required processor speed from 450 Mhz to 1Ghz or higher Updated the browser requirements for viewing the help system Corrected Mac OS software requirements Added QLE2564 to list of supported HBAs Removed instructions to install the application from CD ROM since the CD no longer includes the installation package Added VMware ESX Server Silent Installation Pro cedures Updated the procedures for using application help Corrected NOTE to show that the loopback is dis abled on all Linux inbox drivers Removed the Reports chapter w
91. gent properties Notepad Fie Edt Format View Help node agent polling interval 20 node agent security password 34 1 95669C9A3F 2E8 node agent fabric scanning enable 1 node agent quiet mode enable Q Figure 7 3 Agent properties File 3 Edit the SANsurfer lax file which is located where SANsurfer FC HBA Manager is installed Do one of the following NOTE Press and hold the CTRL key while starting SANsurfer FC HBA Manager to display the messages in the console viewer You can set the displayed levels by updating the local properties file or by following these procedures SN0054651 00 F 7 15 Troubleshooting pad Tracing SANsurfer FC HBA Manager and Agent Activity Debug LOGIC AA NN a Edit the file so that the information appears on the console Change the following properties lax stderr redirect console lax stdout redirect console lax stdin redirect console m Edit the file so that the information is saved to a file as shown for your operating system Q Fora system the location could be lax stderr redirect c trace txt lax stdout redirect c trace txt lax stdin redirect c trace txt Q Fora Red Hat SUSE Linux or Solaris SPARC x86 system the location could be lax stderr redirect trace txt lax stdout redirect trace txt lax stdin redirect trace txt Figure 7 4 shows an example 7 16 SN0054651 00 F XX Troubleshooting LOGIC Tracing SANsurfer FC HBA Manager and Agent A
92. gnostic Testing Preparation differs for the loopback and read write buffer tests In addition you can use the SANsurfer FC HBA Manager to locate the adapter you want to test NOTE The loopback test is disabled on all Linux inbox drivers The following sections provide information about how to prepare for diagnostic testing m Finding the Adapter Port You Want to Test on page 6 2 m Preparing for the Loopback Test on page 6 3 m Preparing for the Read Write Buffer Test on page 6 5 Finding the Adapter Port You Want to Test You can find the location of a port by the way the hardware flashes SANsurfer FC HBA Manager allows you to activate a flash beacon on a port This flash beacon can be toggled on and off Flash the 2xxx adapter port s LED to locate the adapter port in your computer NOTE This feature is not supported on QLA22xx series or older adapters 6 2 SN0054651 00 F XX Performing Diagnostics LOGIC Running Loopback and Read Write Buffer Diagnostic Tests I aaa To flash the adapter port s LED 1 Inthe FC CNA HBA tree right click an adapter port NOTE If you are using a Macintosh mouse one button press CTRL while clicking on the tree 2 On the shortcut menu click Flash Beacon The 2xxx adapter port s LED begins to flash To stop the LED from flashing 1 Inthe FC CNA HBA tree right click the adapter port 2 On the shortcut menu click Flash Beacon The 2xxx FC CNA HBA port s LED stops f
93. gnostic Tests on page 6 1 mg Viewing Adapter Port Transceiver Details on page 6 7 Running Loopback and Read Write Buffer Diagnostic Tests SANsurfer FC HBA Manager offers two diagnostic tests loopback and read write You can access the diagnostic testing facility from the Diagnostics page or by clicking the Diags button on the toolbar Before running a diagnostic test consider the following a Because diagnostic testing interrupts normal adapter operations you should run these tests when no other activities are required of the adapter a The adapter state reverts to pre test conditions at the end of the testing process Diagnostic tests read and write to sensitive areas on the adapter Disruption of some diagnostic tests may require a complete update of the adapter s critical memory areas SN0054651 00 F 6 1 Performing Diagnostics IK Running Loopback and Read Write Buffer Diagnostic Tests QLOGIC AA NY CAUTION Although SANsurfer FC HBA Manager protects against normal operation interruption and testing disruption it is your responsibility to ensure that the diagnostics are run without causing interruptions to other processes and disruptions to the actual testing process The following sections provide information on these diagnostic tests m Preparing for Diagnostic Testing on page 6 2 m Running the Loopback Test on page 6 6 m Running the Read Write Buffer Test on page 6 6 Preparing for Dia
94. hat only targets configured using SANsurfer FC HBA Manager are seen by the system Target Binding Options Indicates that the driver binds the target ID using the target s world wide port name WWPN or port ID SN0054651 00 F 5 29 Getting Started pad Specifying the Adapter Driver Settings LOGIC ee To set the adapter driver parameters 1 In the SANsurfer FC HBA Manager main window FC CNA HBA tree select the adapter 2 Click the Settings tab to open the adapter driver Settings page Figure 5 14 Figure 5 15 shows the same page for Linux only Information Settings Hostname 711 2av59v5hb1 10 3 20 115 HBA Model QLA2300 2310 Driver Settings Target Display Options Present persistently bound target s plus any new target s with driver defaults Present persistently bound target s Only Target Binding Options Bind By World Wide Port Name Bind By Port ID Save Figure 5 14 Settings Page Adapter Driver 5 30 SN0054651 00 F XX Getting Started LOGIC Specifying the Adapter Driver Settings TO HA Information Settings Hostname n7112av59v5hb110 3 20104 HBA Model QLA2300 2310 Driver Settings Target Display Options Present persistently bound target s plus any new targetis with driver defaults Present persistently bound target s Only Present target s with driver defaults Target Binding Options Bind By World Wide Port Name Bind By Port ID Save Figure 5 15 Settings Page L
95. hich is covered in the application help Added keyboard shortcut to launch the Agent qlremote Update Wizard Edited multiple definitions for consistency and added the following new definitions DCBX Echo diagnostic test LIP NPIV QoS and T11 Revision D changes page 2 8 page 7 8 Hardware Requirements on page 3 1 Software Requirements on page 3 2 page 3 3 Supported QLogic Adapters on page 3 4 Installation Instructions on page 4 3 Installation Instructions for VMware ESX 3 5 on page 4 19 Viewing the Help System on page 5 13 Preparing for Diagnostic Testing on page 6 2 page B 2 Glossary Updated Linux and Solaris steps for downloading an installation package Added parenthetical statement to second bulleted item that notes the feature limitation Revision E changes Applied new page template and formats entire manual Revision F changes Updated text and screens to show updated naming conventions and QLogic logo entire manual SN0054651 00 F XX LOGIC The Ultimate in Performance Table of Contents Preface What sinthisGuide xi IntendedAudience xii Related Materials xii Documentation Conventions xiii License Agreements a ic dca wees See a ede bak KAKA
96. i E 10 x Uninstall Complete The following items could not be removed SANsurfer XX OLOGiC Unable to remove registry key HKEY_LOCAL_MACHINE SOF TWARE QLogic Cor a InstallAnywhere by Zero G Cancel Previous Figure 4 27 Uninstall SANsurfer Uninstall Complete Click Done If any components were not successfully uninstalled manually remove them Some files and directories remain after uninstalling SANsurfer You must delete these components manually from the computer s hard disk where SANsurfer was installed The default locations are a For Windows Program Files Qhogic Corporation SANsurfer E For Red Hat SUSE Linux and Solaris SPARC x86 opt QLogic Corporation SANsurfer 8 Ifyou selected Add Remove Programs in Step 1 to uninstall SANsurfer HBA Manager from a Windows system follow these steps a To exit the Add Remove Programs dialog box click Cancel b To exit the Control Panel click Close 9 If prompted reboot the system 4 32 SN0054651 00 F XX LOGIC The Ultimate in Performance 5 Getting Started This section includes the procedures for starting and exiting the SANsurfer FC HBA Manager user interface and customizing the tool options and policies It provides information on Starting SANsurfer FC HBA Manager on page 5 1 SANsurfer FC HBA Manager Main Window on page 5 5 Exiting SANsurfer FC HBA Manager on page 5 12 Getting Help on page 5 12 Setting SA
97. ialog box select localhost 7 10 SN0054651 00 F XX Troubleshooting QLOGIC Verifying that the Adapter Driver is Installed TO NE m The DNS or the local host file may contain an incorrect IP address for the host name Use the ping command to ping the host name and then verify that the correct IP address is translated from the name If necessary reinstall the adapter driver To verify that the adapter driver is installed on Windows 1 Right click the My Computer desktop icon On the shortcut menu click Manage 2 Inthe left pane of the Computer Management window click Device Manager In the right pane click SCSI and RAID controllers 3 Right click a QLogic FC Adapter which is a QLogic adapter port On the shortcut menu click Properties On the QLogic Fibre Channel Adapter Properties click the Driver tab On the Driver page click the Driver Details button On the Driver File Details dialog box Driver files list select the driver The file version appears below 7 Repeat the process for each adapter port as appropriate To verify that the adapter driver is installed on Netware 1 At the server command prompt type the following command and then press ENTER modules q 2 Verify that the QLogic adapter driver is installed To verify that the adapter driver is installed on Red Hat SUSE Linux 1 Type the following command and then press ENTER lsmod the letter L 2 Verify that the QLogic adapter driver is
98. ics Device List or Link Status Unable to display or modify the adapter parameters or the Utilities tab is missing Unable to run update flash BIOS Unable to run device replace ment Unable to run the loopback test Unable to run the read write buffer test Cause The qlremote agent is not running or is not installed Solution Verify that the qlremote agent is installed and running see Verifying that qlremote is Installed and Running on page 7 12 Cause m Adapter parameters are corrupted or E Adapter Subsystem Identification Subsystem Vendor Identification SSID SSVID is missing from adapter properties Solution If the adapter parameters are corrupted use FlashUTIL to reflash the adapter parameters If the SSVID SSDID is missing from adapter properties perform a tool update or manually modify adapter properties Cause This feature is not supported for all operating systems Solution The Update Flash utility is available only for Windows XP Professional Windows 2000 Windows Server 2003 Windows Vista Windows Server 2008 and Red Hat SUSE Linux Cause Device removal is not detected or a new device was not inserted Solution Before running the Device Replacement utility ensure that you first remove the device to be replaced and then insert the new device Cause A loopback connector was not attached to the FC connector on the adapter Solution A loopback connector must be attached
99. ify that the appropriate operating system driver is loaded Refer to the readme txt file for supported operating system drivers E Verify that the qlremote agent is running on the local or remote host Check agent logs for any problems while querying information see the SANsurfer FC HBA Manager Application Help Cause The operating system driver did not find devices during the ini tial load Solution Verify that the operating system driver detects the devices If the operating driver does not detect devices neither does SANsurfer FC HBA Manager Check agent logs for any problems while querying information see the SANsurfer FC HBA Manager Application Help Cause An incorrect or unsupported operating system driver is installed Solution Refer to the readme txt file for a list of supported operating system drivers Cause The path to the browser is not correctly specified Solution In the SANsurfer FC HBA Manager main window Help menu click Set Browser Location to specify the path see Specifying the Help Browser on page 5 14 See Software Requirements on page 3 2 for supported browsers SN0054651 00 F XX Troubleshooting QLOGIC Troubleshooting Problems and Solutions ls Table 7 2 Troubleshooting User Interface and Remote Agent Issues Continued Problem Cause and Solution SANsurfer FC HBA Manager Cause There is a disconnect with the qlremote agent or network com user interface does not aut
100. igure 5 1 on your desktop if the icon was created during installation If you have an older version of SANsurfer FC HBA Manager and are upgrading to the current version the old icon image appears ae Ale SaNsurfer Figure 5 1 SANsurfer Icon E On the Windows Start menu point to Programs point to QLogic Management Suite and then click SANsurfer m On the Windows Start menu click Run and then do one of the following LJ Type in the SANsurfer program file name SANsurfer EXE including all the paths and then click OK Q Click Browse find and select the program in the Browse dialog box and then click Open SANsurfer FC HBA Manager opens see SANsurfer FC HBA Manager Main Window on page 5 5 5 2 SN0054651 00 F XX Getting Started QLOGIC Starting SANsurfer FC HBA Manager OO U a Starting SANsurfer FC HBA Manager on Linux or Solaris NOTE If you want to connect to one or more specified hosts automatically when starting SANsurfer FC HBA Manager see Connecting to Hosts Automatically Linux Solaris or Macintosh CLI on page 5 4 On Red Hat SUSE Linux and Solaris SPARC x86 systems follow these steps to start the SANsurfer tool which includes SANsurfer FC HBA Manager To start SANsurfer FC HBA Manager on Linux or Solaris 1 Ensure that you are in a graphical user environment 2 Open a command terminal 3 Type SANsurfer and then press ENTER SANsurfer FC HBA Manager
101. ile uninstalling SANsurfer FC HBA Manager from a NetWare server the server s prompt displays the message Cannot start sys etc rpcnet cfg This does not affect the operation of the NetWare server and can be ignored m The uninstall process leaves behind some files and directories You must manually delete these files To uninstall SANsurfer FC HBA Manager 1 To start the SANsurfer uninstaller from a Windows system choose one of the following methods E On the Windows Start menu point to Programs point to QLogic Management Suite and then click SANsurfer Uninstaller m To use Add Remove Programs follow these steps a On the Windows Start menu point to Settings and then click Control Panel b Double click the Add Remove Programs icon to open the Add Remove Programs dialog box Figure 4 22 4 26 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Uninstalling SANsurfer ls k Add Remove Programs E ji 10 x gt a CT Currently installed programs Sort by Name x Change or mg SANsurfer Remove 3 3 Programs Click here for support information a YA To change this program or remove it From your Change Remove p 4 computer click Change Remove Change Remove Add New Programs Add Remove Windows Components Figure 4 22 Uninstall SANsurfer Add Remove Programs Windows 2000 In the left column click Change or Remove Programs default Under Currently Installed Programs select SANsurfer
102. ileges for the selected host by entering the system login and password you use to access the machine a In the Login box type the login name that has administrator or root privileges on the host you selected b In the Password box type the login password associated with the login name Under Application Access modify the SANsurfer FC HBA Manager access password a In the Current Password box type the current password b In the New Password box type the new password c Inthe Verify New Password box type the new password again to confirm the new password Do one of the following m To update the tool access password click Apply m To delete the typed entries on the Security page click Clear Fields 5 17 Getting Started IK Setting the Warning Display Option QLOGIC AA NY Setting the Warning Display Option You can configure SANsurfer FC HBA Manager to display warning messages when specific conditions occur To set the warning display option 1 To access the Options dialog box choose one of the following methods m Onthe SANsurfer FC HBA Manager main window open the Settings menu and then click Options mo Right click the FC CNA HBA tree and then on the shortcut menu click Options m Press CTRL SHIFT T The Options dialog box opens Figure 5 6 Warning Displays v Enable Warning Displays Figure 5 6 Options Dialog Box Warning Displays 2 Under Warning Displays do one of the following
103. indows Vista Windows Server 2008 Red Hat Linux Advance Server Novell SUSE Linux Enterprise Server SLES Solaris SPARC Solaris x86 Novell NetWare Mac OS X VMware ESX Ooo oOo SN0054651 00 F 1 1 SANsurfer FC HBA Manager Overview pad Features LOGIC Aa NY NOTE For specific OS service packs SP and updates refer to the descriptions where this software version is posted on the QLogic website http support qlogic com support drivers software aspx m SANsurfer FC HBA Manager is a client server tool The networking capability of the tool allows for centralized management and configuration of QLogic Fibre Channel adapters and converged network adapters within the entire SAN For scripting capabilities use the SANsurfer Command Line Interface CLI tool Features SANsurfer FC HBA Manager provides the following features m Automatic update management To easily keep SANsurfer FC HBA Manager up to date at all times by monitoring the tool version number enable the Application Version Check feature on the Schedule Task dialog box see Scheduling Tasks in the help system You can perform tool updates apply updates from the Web as well as from an external media location CD Java Web Start is also available which automatically downloads caches and runs the given updates for the SANsurfer FC HBA Manager tool m Adapter asset and inventory management SANsurfer FC HBA Manager allow
104. ing the Loopback Test The loopback test is external to the adapter If the adapter port is in loop mode you can run the loopback test with a loopback connector If the adapter port is in point to point mode and attached to a switch an echo test is run instead no loopback connector is used In addition some driver versions do not require a loopback connector See Preparing for the Loopback Test on page 6 3 for information The test evaluates the ports transmit and receive transceivers on the adapter More specifically the loopback test transmits and receives loopback the specified data performs a frame cyclic redundancy check CRC and looks for disparity and length errors To run a loopback test 1 Prepare for the test see Preparing for Diagnostic Testing on page 6 2 2 Set the diagnostic test parameters see Setting the Diagnostic Test Parameters in the help system Run the diagnostic test see Running Diagnostic Tests in the help system View the diagnostic test results see Viewing the Diagnostic Test Results in the help system 5 Prepare for normal adapter operations see Preparing for Normal Adapter Operations on page 6 4 NOTE m The loopback test must be run with the loopback connector unless the operating system uses one of the driver versions listed in the Table 6 1 m The loopback test is disabled if you are using inbox drivers with SLES 10 0 Running the Read Writ
105. ing the uninstall If No is chosen and the previously installed version resides in the same directory as the currently selected directory then the previous version will be ovenwritten Figure 4 7 Previous SANsurfer Install Detected Message 4 10 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Initial Installation TO A 7 Respond to the previous installation message a If the SANsurfer tool is currently running exit SANsurfer before proceeding with the installation b Choose one of the following options H If you want to uninstall the previous version click Yes The previous version is uninstalled NOTE If you are installing on a Windows system and you are prompted to reboot the system after the uninstall is complete be sure to reboot before installing in the same directory as the currently selected directory Otherwise the newly installed tool will not operate properly H If you do not want to uninstall the previous version click No If the previously installed version resides in the same directory as the currently selected directory the previous version is overwritten If you are installing the SANsurfer FC HBA Manager user interface on a Windows system except Windows Vista or Windows 2008 Server the Select Shortcut Profile dialog box opens Figure 4 8 Select Shortcut Profile Select the desired profile to install the application shortcuts SANsurfer p Q LO G l CG Current
106. ingle processor or multiprocessor server or workstation Pentium Il with 1GHz or greater for Windows XP Professional Windows 2000 Windows Server 2003 Windows Vista Windows Server 2008 Red Hat SUSE Linux Solaris x86 or NetWare LY Sun Ultra 60 for Solaris SPARC QO Power Mac G5 1 8 MHz or greater with 512 MB of memory or Mac with Intel processor 2 0 GHz or greater with 1 GB of memory m FC devices such as disks and RAID subsystems SANsurfer FC HBA Manager supports most FC devices For a complete list of devices that support failover 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 NOTE Tape devices are displayed as part of the configuration but are not fully supported by SANsurfer only LUN masking m 256 MB of physical RAM is required to run the SANsurfer FC HBA Manager 512 MB is recommended Running with less memory can cause disk swapping which severely affects performance SN0054651 00 F 3 1 System Requirements pad Software Requirements LOGIC E Se m Video card capable of 256 colors and a screen resolution of 800x600 pixels are required 16K colors and 1024x768 pixels are recommended m About 150 MB of disk space Software Requirements The minimum software requirements are as follows Common desktop environment CDE to
107. inux Failover Driver Only The identifying information includes a Hostname is the name or IP address of the host connected to the adapter E Adapter Model is the QLA2xxx adapter model number 3 Under Target Display Options click one of the following to specify whether only targets configured using SANsurfer FC HBA Manager are seen by the system m fyou want the system to see all targets at all times whether or not the target was configured with SANsurfer FC HBA Manager click Present targets that are persistently bound plus any new target s with driver defaults m Ifyou want the system to see only targets configured using SANsurfer FC HBA Manager click Present persistently bound target s Only m Linux failover driver only If you want the system to see only targets with driver defaults click Present target s with driver defaults This option is available only for Linux operating systems NOTE If you select the Linux option Present target s with driver defaults the system ignores persistent data SN0054651 00 F 5 31 Getting Started pad Refreshing the Host Configuration LOGIC A ee 4 Under Target Binding Options select one of the following binding options f you want the driver to bind the target ID using the target s WWPN click Bind by World Wide Port Name f you want the driver to bind the target using the target s port ID click Bind by Port ID Failover and LUN masking are disabled If the t
108. ion see the SANsurfer FC HBA Manager Application Help SN0054651 00 F 7 1 Troubleshooting pad Troubleshooting Tools QLOGIC T Se In addition you can search the QLogic Support knowledge base and user forums to help determine if the event is generated by the QLogic driver Microsoft or other source Go to http support glogic com and in the Search input box do one of the following and then click Search m Type Event ID to search for all events in the knowledge base m Type a specific Event ID number m Type 6389719 to find and open the document Interpretation of the QLA2xxx Windows Event Log Error Codes Driver version 9 00 00 and above mM Type 3346764 to find and open the document Interpretation of the QLA2xxx Windows Event Log Error Codes For driver versions prior to 9 00 00 Miniport driver logs The miniport driver logs events for significant driver errors Due to a limitation of the Windows miniport driver interface the miniport can log only two 32 bit values for any event Information about interpreting these event codes is in the eventlog txt file which is shipped with the miniport driver In addition the miniport driver can be configured to perform extended event logging for an adapter which causes it to log all loop transitions and many minor events Extended Application Event Logging uses extra overhead and is enabled only in troubleshooting situations The extended Application Event Logging flag is
109. ious Figure 4 25 Uninstall SANsurfer Choose Product Features The uninstaller s Choose Product Features dialog box differs depending on whether you are installing on a Windows Red Hat SUSE Linux or Solaris SPARC x86 system 4 Clear the check boxes for features that you want to uninstall Selected check boxes identify features that will remain installed Select from the following components all components may not appear and the order of the components may vary a For a Windows system Q SANsurfer FC HBA Manager C1 SANsurfer FC NetWare 5 6 x Agent QO SANsurfer FC Windows Agent QO Help mE Fora Red Hat SUSE Linux system QO SANsurfer FC HBA Manager Uu SANsurfer FC Linux Agent Oh Help m Fora Solaris SPARC x86 system QO SANsurfer FC HBA Manager QO SANsurfer FC Solaris Agent U Help 4 30 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Uninstalling SANsurfer ls 5 Click Uninstall The Uninstall SANsurfer dialog box Figure 4 26 lists the components to be uninstalled O Uninstall SANsurfer SANsurfer POWERED BY XX GLOGIC Figure 4 26 Uninstall SANsurfer Uninstall SANsurfer A message asks you to wait the while the uninstaller removes the components The Uninstall Complete dialog box informs you when the uninstall is complete Figure 4 27 SN0054651 00 F 4 31 Installing SANsurfer FC HBA Manager pad Uninstalling SANsurfer LOGIC 4 Uninstall SANsurfer
110. is open var adm messages to view which target devices are configured on which adapters Step 4 Install any RAID Filter Drivers 2 10 Some RAID subsystems including some CLARiiON EMC and LSI subsystems provide redundancy by using the subsystem to provide the same LUNs through two separate controllers in the subsystem These controllers appear as unrelated target devices to adapters and miniport drivers They are tied together in the driver stack through a filter driver that understands the relationship between these target devices and can move LUNs back and forth between controllers To install and verify RAID filter drivers see your RAID subsystem installation documentation or associated software documentation If you do not have any such drivers to install skip to Step 5 Install and Run SANsurfer FC HBA Manager SN0054651 00 F XX System Overview LOGIC Installation Checklist Step 5 Install and Run SANsurfer FC HBA Manager SANsurfer FC HBA Manager is a management tool used to view manage and diagnose QLogic adapters SANsurfer FC HBA Manager also configures adapters target devices on the adapters and LUNs on target devices To use target masking LUN masking or device hot replacement features of SANsurfer FC HBA Manager you must install SANsurfer FC HBA Manager See Installing SANsurfer FC HBA Manager on page 4 1 for complete installation instructions NOTE Macintosh systems do not use failover If
111. ive E On the Novell NetWare Disk Selection dialog box type the drive letter in the Enter Drive Letter box and then click Enter Drive Letter In Figure 4 12 for example you could type C in the Enter Drive Letter box and then click Enter Drive Letter C Click Next If you are installing SANsurfer FC HBA Manager on a Novell NetWare Red Hat SUSE Linux or Sun Solaris system the Default QLogic Failover Enable Disable dialog box opens Figure 4 13 T SANsurfer AE E Default QLogic Failover Enable Disable S ANsurfer Select the default glogic failover configuration POWERED B Y XX OLocic F7 Enable Qlogic Falover Configuration installAnywhere by Macrovision Cancel Figure 4 13 Install SANsurfer Default QLogic Failover Enable Disable SN0054651 00 F 4 15 Installing SANsurfer FC HBA Manager pad Initial Installation QLOGIC TE NY The failover path feature ensures data availability and system reliability by assigning alternate path and automatic adapter failover for device resources 12 To enable failover select the Enable QLogic Failover Configuration check box and then click Next The Launch SANsurfer Application dialog box opens Figure 4 14 T SANsurfer ile KI Launch SANsurfer Application SANsurf Select the Launch Application checkbox to execute the SANsurfer application to configure surter the attached hardware POWERED BY XX oLocic installAnywhere by Macrovision C
112. k Cancel Q To view which devices are being shared with hosts that are conflicting with this policy click More Q Configure the selected device and display a message if the device is already configured on another host s This policy configures the selected device and shows a message if the device is configured on another host If you select this policy and this type of sharing is detected a warning appears Do one of the following U To disable access to these devices from other hosts click OK Q To disable this policy for this instance click Cancel Q To view which devices are being shared with hosts that are conflicting with this policy click More Ask these options when a device is configured and sharing is detected If you select this policy and sharing is detected the Shared Device Found dialog box Figure 5 12 opens Click one of the following options QO Donot configure device Uu Configure and disable access from other hosts Q Proceed with device configuration To accept your selection click OK To not configure the device click Cancel 3 LUN sharing checking occurs each time a configuration change is made to a LUN On the Policy Settings dialog box Figure 5 11 under Options for sharing LUNs among host s complete the following m To disable LUN sharing checking clear the Check for shared enabled LUNs among host s check box m To enable device sharing checking select the Check fo
113. lashing Preparing for the Loopback Test Perform the steps in this section before running the loopback test NOTE The loopback test is disabled if you are using inbox drivers with SLES 10 0 To prepare to run the loopback test 1 Modify the Connection Options setting see Modifying the Adapter Settings Connection Options Setting in the help system 2 Attach a loopback connector to the FC connector on the adapter port see Installing a Loopback Connector on page 6 4 Skip this step under the following conditions an echo test will be run instead m You have a 2xxx adapter that is connected to the fabric through a point to point connection F Port The adapter is connected to a switch Your operating system has one of the driver versions listed in Table 6 1 SN0054651 00 F 6 3 Performing Diagnostics pad Running Loopback and Read Write Buffer Diagnostic Tests QLOGIC Ce Table 6 1 Driver Versions That Do Not Require a Loopback Connector Operating System Driver Version Windows 2000 Windows Server 2003 with SCSI miniport driver 8 2 3 11 and above Windows XP Professional Windows Server 2003 Windows Vista 8 2 3 16 and above with Storport miniport driver Red Hat SUSE Linux 6 06 00 and above Solaris SPARC 4 12 and above Solaris x86 4 15 and above Novell NetWare 6 80 and above 3 If the adapter port is connected to the fabric through a point to point connection F_Port and is connecte
114. lation does not copy Cause There is insufficient disk space or not enough available mem files Ory Solution The installation detects when there is insufficient disk space When sufficient disk space is available continue the installation For disk space and physical RAM requirements see Hardware Require ments on page 3 1 or the readme txt file Installation reports that there Cause There is insufficient disk space or not enough available mem is no space available ory Solution The installation detects when there is insufficient disk space When sufficient disk space is available continue the installation For disk space and physical RAM requirements see Hardware Require ments on page 3 1 or the readme txt file 7 4 SN0054651 00 F XX QLOGIC Troubleshooting Troubleshooting Problems and Solutions ls User Interface and Remote Agent Issues Table 7 2 lists problems related to the SANsurfer FC HBA Manager user interface and remote agent and provides possible causes and solutions Table 7 2 Troubleshooting User Interface and Remote Agent Issues Problem Cause and Solution Unable to start the SANsurfer FC HBA Manager user inter face using the desktop short cut SANsurfer icon SANsurfer FC HBA Manager user interface starts and then hangs indefinitely SANsurfer FC HBA Manager user interface cannot connect to the local host SANsurfer FC HBA Manager user interface is not co
115. le 7 2 examples of system configurations 2 1 exiting SANsurfer FC HBA Manager 5 12 exporting agent activity 7 19 7 20 7 21 HBA event logs automatically 5 22 qlremote log file 7 21 extended Application Event Logging 7 2 7 3 F Fabric Glossary 3 Fabric switch Glossary 3 Failover Glossary 3 failover driver 2 11 Macintosh not supported 2 11 Failover API Macintosh 2 12 FAQs A 1 Fast UTIL Glossary 3 Fast UTIL adapter BIOS utility 2 9 FC Glossary 3 FC CNA HBA tree adapter icons and text 5 9 host icons and text 5 9 viewing 5 6 FCode Glossary 3 utility 2 9 FCoE Glossary 3 SN0054651 00 F features of SANsurfer FC HBA Manager 1 2 advanced 1 4 asset management 1 2 configuration management 1 2 diagnostics 1 3 event notifications 1 3 NPIV 1 4 QoS 1 4 statistics 1 3 update management 1 2 Fibre Channel Configuration dialog box 7 8 Fibre Channel Port Configuration dialog box 5 7 File Download dialog box 4 4 flash Glossary 3 FlashUTIL reflashing adapter parameters 7 9 frequently asked questions A 1 G General page Transceiver Details Diagnostics 6 8 getting started 5 1 graphics adapter requirements 3 2 H HAM Glossary 2 hardware required for SANsurfer FC HBA Manager 2 7 3 1 HBA Diagnostics dialog box 5 8 HBA Event Log configuration change events 5 19 HBA Events button 5 8 HBA Statistics dialog box 5 8 help system browser specifying location 5 14 viewing 5 13 hide help system navigation pane 5 13 hidin
116. load balancing Loopback A diagnostic tool where data is transmitted and received by the HBA LUN Logical Unit Number The small integer handle that identifies a portion of disk storage ALUN can consist of a single physical disk or many physical disks A physical disk can be broken into multiple LUNs LUN masking A software feature that assigns LUNs to specific servers or hides LUNs from specific servers for maximum access and availability control Media Electronic carriers of information FC supports several different physical media copper multimode optical and single mode optical which differ mainly in the maximum cable length All FC proto cols are supported on all media SN0054651 00 F XX QLOGIC SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters aang NIC Network Interface Controller A computer circuit board or card that is installed in a computer so that it can be connected to a network NPIV N Port ID Virtualization A Fibre Channel facility that allows multiple N Port IDs to share a single physical N Port This allows multiple FC initiators to occupy a single physical port See Port NVRAM NonVolatile Random Access Memory Memory that stores HBA configuration settings You can configure adapter settings or restore them from a file These settings are saved in NVRAM and are retained when power is removed ONC Open Network Computing
117. lock A command structure in QLogic ISP architecture loctl Input output 1 0 control A system call found on Unix Linux systems allowing an application to control or communicate with a device driver outside the usual read write operations Internet Protocol A method by which data is sent from one computer to another over the Internet IP specifies the format of packets also called datagrams and the addressing scheme iSCSI Internet Small Computer Systems Inter face ISP Intelligent Storage Peripheral QLogic trademark and family of Fibre Channel and iSCSI controller chips that replace network interface chips in network adapters servers and storage JBOD Just a Bunch Of Disks JNLP Java Network Launching Protocol The protocol defined in an XML file format that specifies how Java Web Start applica tions are launched Glossary 4 LIP Loop Initialization Process The initializa tion process in an arbitrated loop that occurs when the loop is powered up or a new device is added One function of a LIP is to assign addresses All data transmis sion on the loop is suspended during a LIP Load balancing A software feature that improves system performance by balancing device access between multiple HBAs for maximum resource efficiency This feature is avail able in Windows 2000 Windows Server 2003 Windows Vista Novell NetWare and Red Hat SUSE Linux Windows XP and Windows Server 2008 do not support
118. lremote gt AgentOutput txt 2 gt amp 1 5 Open a second terminal to start the SANsurfer FC HBA Manager user interface Connect to the host with SANsurfer FC HBA Manager 6 On the terminal you opened in Step 1 press CTRL C to stop the qlremote agent This causes the agent to clean up and terminate From a Solaris SPARC x86 system follow the steps below to export agent activity To export agent activity on Solaris 1 Open a terminal for example xterm or dtterm 2 To stop the currently running qlremote agent do the following a To determine the process identifier pid of qlremote type the following and then press ENTER ps ef grep qlremote The pid is shown as in the following example Note that in the example the pid is 227 root 227 1 0 15 59 55 2 0 00 opt QLogic Corporation SANsurfer qlremote root 410 409 0 16 01 46 pts 6 0 00 grep qlremote b Type the following and then press ENTER kill TERM pid NOTE The pid is the identifier returned in Step a 3 Inthe agent properties file add the following line node agent quiet mode enable 1 4 Start the agent again without forking into the background Redirect the stdout and stderr properties to a file see Tracing SANsurfer FC HBA Manager User Interface Activity Step 3 Send the file to your authorized service provider installation folder qlremote gt AgentOutput txt 2 gt 61 7 20 SN0054651 00 F XX Troubleshooting QLOGIC
119. ly adapter without an agent standalone sansurfer solaris install bin i silent DSILENT INSTALL SET QMSJ G m Solaris To install all user interfaces and all agents standalone sansurfer solaris install bin i silent DSILENT INSTALL SET QMSJ G SA 4 18 SN0054651 00 F XX QLOGIC Installing SANsurfer FC HBA Manager Initial Installation I Installation Instructions for VMware ESX 3 5 The VMware ESX 3 5 console does not support Xwindows which is required to display Graphical User Interface GUI applications on UNIX platforms You can manage QLogic FC adapters from the SANsurfer FC HBA Manager application installed on a Windows system The FC HBA Manager on Windows can connect remotely to the qlremote running on the ESX server and manage adapters on the ESX server To prepare your servers to manage the FC adapters remotely 1 SN0054651 00 F Install the FC HBA Manager on the ESX server using the following CLI command in silent mode sh standalone sanaurfer5 0 lbxx linux install bin i silent DSILENT INSTALL SET QMSJ_G LA x86 where xx is the build number Start the portmap service on the ESX server For example enter the following command sbin portmap Start qlremote on the ESX server For example enter the following command usr local bin qlremote On a Windows server install the SANsurfer FC HBA Manager Windows 5 0 1bxx client
120. mitting data over virtual ports by setting priorities and allocating bandwidth SAN Storage Area Network A high speed network that interconnects multiple storage units and servers used by a larger network of users Glossary 5 SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters XX QLOGIC ee SCSI Small Computer System Interface A hardware bus specification and a packet oriented protocol specification for communicating on that bus SCSI over FC uses the packet oriented protocol to communicate with storage devices on the FC SPIFFI Specification for Platform Independent Failover and Failback Integration A cooperative effort that defines a non vendor specific failover mechanism SYSFS A virtual file system provided by the 2 6 Linux kernel Sysfs exports information about devices and drivers from the kernel device model to userspace and is also used for configuration T11 A subcommittee of the International Committee for Information Technology Standards INCITS that establishes the standards for Fibre Channel technology Target Devices such an HBA card which mediate data in a computer network The term device is used interchangeably with target and target device See Device Target binding The process in which the HBA driver binds a target ID using a target s world wide port name WWPN or port ID This enables the target ID to always connect to the WWPN
121. n the keyboard to complete a task Table B 1 lists the shortcut keys available SANsurfer FC HBA Manager and the purpose of each Table B 1 Shortcut Keys Press To ALT X Exit SANsurfer CTRL N Configure FC ports F5 Refresh INSERT Connect to host CTRL O Load from file CTRL S Save to file CTRL T Save to text file CTRL SHIFT C Compare host DELETE Disconnect selected host CTRL SHIFT BACK Disconnect all hosts SPACE CTRL P Display current path CTRL SHIFT O Open host group CTRL SHIFT S Save host group CTRL SHIFT E View tool event log CTRL SHIFT A View HBA event log CTRL SHIFT H Schedule tasks CTRL SHIFT R Generate reports SN0054651 00 F B 1 Shortcut Keys XX QLOGIC ee Table B 1 Shortcut Keys Continued Press To CTRL SHIFT Z Collect config logs CTRL SHIFT T Set options CTRL SHIFT M Set e mail CTRL SHIFT B Set broadcast CTRL SHIFT P Set policies CTRL G Launch General Configuration Wizard CTRL R Launch Flash Update Wizard SAN CTRL V Launch Driver Update Wizard SAN CTRL M Launch HBA Parameters Update Wizard SAN CTRL W Launch HBA Parameters File Update Wizard SAN CTRL I Launch iiDMA Settings Wizard SAN CTRL L Launch LUN Masking Wizard CTRL F Launch Failover Wizard CTRL Q Launch Agent qlremote Update Wizard SAN F1 Browse online help contents F2 Set online help browser location CTRL U Check for Updates Now B 2 SN0054651 00 F Glossary Adapter See HBA and CNA AL_PA Arbitrated Loop
122. nced Ethernet and Fibre Channel over Ethernet FCoE CRC Cyclic Redundancy Check A CRC is a type of check value designed to catch most transmission errors CSV file Comma Separated Values file DCBX Data Center Bridging Exchange A networking protocol that allows switches and their target devices to automatically exchange Ethernet parameters Glossary 1 SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters XX QLOGIC E e Device A computer subsystem such an adapter card which mediates data in a computer network The term device is used inter changeably with target and target device See FCoE Driver Software that interfaces between the file system and a physical data storage device or network media The level structure for Windows drivers is as follows m Class driver is the highest driver level There is a separate class for disk Ethernet and so on This level handles all generic aspects of operations for that class m Port driver is the middle driver level which handles aspects of the operation specific to the port type for example there is a port driver for SCSI m Miniport driver is the lowest driver level and device specific This level is usually supplied by the manufacturer as a companion to a physical device E Monolithic driver level combines the functions of different driver levels in the same driver to increase performance
123. nd IP which is primarily used in SANs ANSI standardized Fibre Channel in 1994 SN0054651 00 F FCode A type of boot code designed for use on Sun s SPARC or Apple Macintosh hardware platforms See Boot code and Flash FCoE Fibre Channel over Ethernet FCoE is a new technology defined by the T11 standards body that allows traditional FC storage networking traffic to travel over an Ethernet link by encapsulating FC frames inside Layer 2 Ethernet frames For more information visit www fcoe com Flash Non volatile memory where the boot code is saved At times Flash and Boot code are used interchangeably Flash BIOS Flash programmable read only memory PROM that contains the code for booting from the adapter at startup HBA Host Bus Adapter The board that inter faces between the host system and device HBA is synonymous with host adapter adapter and adapter board HBA alias A user defined name for an HBA You may use up to 256 characters when creating an HBA alias HBA port A port on the HBA HBA port alias A user defined name for an HBA port You may use up to 256 characters when creating an adapter port alias Glossary 3 SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters XX QLOGIC E Se HBA port beacon A SANsurfer FC HBA Manager feature that enables you to flash the adapter s LED to locate the adapter in your computer IOCB O Control B
124. nformation Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance QLogic Technical Support can be reached by the following methods Web http support qlogic com Email support qlogic com The QLogic knowledge database contains troubleshooting information for the QLogic adapters Access the data base from the QLogic Support Web page http support glogic com Use the Support Center search engine to look for specific troubleshooting information SN0054651 00 F XV XX QLOGIC AA NY Notes xvi SN0054651 00 F XX LOGIC The Ultimate in Performance 1 SANsurfer FC HBA Manager Overview QLogic SANsurfer FC HBA Manager is a collection of device drivers and GUl based device management tools for configuring and managing QLogic Fibre Channel FC and Fibre Channel over Ethernet FCoE adapters NOTE Throughout this guide the term Windows refers to all supported versions of the Microsoft Windows operating system including Windows XP Professional Windows 2000 Windows Server 2003 Windows Vista and Windows Server 2008 unless otherwise specified Environments SANsurfer FC HBA Manager is a client server tool supported on multiple operating systems m SANsurfer FC HBA Manager allows control of heterogeneous environments by supporting multiple operating systems including QO Windows XP Professional Windows 2000 Windows Server 2003 W
125. nnect ing to a local host SANsurfer FC HBA Manager user interface cannot connect to a remote host Cause The desktop shortcut has an invalid path or SANsurfer FC HBA Manager was not completely installed Solution Verify that the desktop shortcut points to the SANsurfer exe file This program is installed by default in the follow ing folder for Windows and NetWare user interface only C Program Files QLogic Corporation SANsurfer Cause There is insufficient memory Solution For physical RAM requirements see Hardware Require ments on page 3 1 or the readme txt file Cause The adapter driver may not be installed Solution Verify that the adapter driver is installed see Verifying that the Adapter Driver is Installed on page 7 10 Cause Depending on your network configuration you may not see all your local hosts respond within the 30 second Broadcast Interval default setting Solution In the Broadcast Settings dialog box increase the Broad cast Interval to the appropriate value above 30 seconds This allows your network the time to respond Cause The qlremote agent is not installed on the remote system or the network protocol is not properly configured Solution E Verify that the qlremote agent is installed on the remote host See System Requirements on page 3 1 and Initial Installation on page 4 1 for network requirements See the SANsurfer FC HBA Manager Application Help for
126. o munication has stopped matically refresh Solution E Verify that the qlremote agent is installed and running see Verifying that qlremote is Installed and Running on page 7 12 E For network requirements see System Requirements on page 3 1 and Installing SANsurfer FC HBA Manager on page 4 1 SANsurfer FC HBA Manager Cause There is a disconnect with the qlremote agent or network com user interface loses the con munication has stopped nection to a host Solution E Verify that the qlremote agent is installed and running see Verifying that qlremote is Installed and Running on page 7 12 E Verify that the appropriate network protocol is running SANsurfer FC HBA Manager Cause SANsurfer FC HBA Manager user interface lost communication user interface crashes with the qlremote agent another application caused a conflict with SANsurfer FC HBA Manager or an operating system driver lost com munication with the adapter or device Solution E Verify that the qlremote agent is installed and running see Verifying that qlremote is Installed and Running on page 7 12 E Verify that no other application is causing SANsurfer FC HBA Man ager to crash E Verify that the operating system driver detects the adapter or device Host keeps disconnecting Cause FC protocol activity caused the qlremote agent to rescan the from and connecting to the configuration FC CNA HBA tree Solution If SANsur
127. ogic com click the Downloads tab b In the selection box Figure 4 1 click Fibre Channel HBAs in the left column your adapter model number in the middle column and your operating system in the right column by Model by Operating System Fibre Channel HBAs iSCSI HBAs InfiniBand HCAs Controller Chips Fibre Channel Switches Intelligent Storage Routers Windows Server 2003 32 bit Windows Server 2003 64 bit Windows XP Professional 32 bit Windows XP Professional x64 Windows Vista 32 bit Windows Vista 64 bit v MMMM Figure 4 1 SANsurfer Download Selections Example Click Gol Scroll down to the Management Tools table and click the appropriate version of SANsurfer FC HBA Manager for your operating system e Onthe End User Software License Agreement page read this important information and then click Agree to continue f On the File Download dialog box click Save Select a directory on your system and then click Save As to download the file g Optional In the Management Tools table select and download the Readme and Release Notes files for the appropriate version of SANsurfer FC HBA Manager 2 Start the installer as described for your operating system HB For a Windows system locate the folder where you downloaded the install file and double click the file 4 4 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Initial Installation ls E Fo
128. ollowing and then press ENTER SANsurfer h hostname hostname is the host name or IP address For example SANsurfer h adsw2ksys2 m To connect to the hosts listed in a group file hst at startup type the following and then press ENTER SANsurfer g path path is the path of the host group file For example SANsurfer g opt QLogic Corporation SANsurfer hostfiles group1 hst SANsurfer FC HBA Manager Main Window The main window gives you access to the features of SANsurfer FC HBA Manager including m Toolbar Buttons on page 5 7 Host Icons and Text on page 5 9 Adapter Icons and Text on page 5 9 Adapter Port Icons and Text on page 5 10 Device Icons and Text on page 5 11 LUN Icons and Text on page 5 12 When the main window first opens it displays the Topology page which shows a traffic signal The traffic signal indicates the status of the hosts as shown in Table 5 1 SN0054651 00 F 5 5 Getting Started pad SANsurfer FC HBA Manager Main Window LOGIC AA NN Table 5 1 Traffic Signals Signal Indicates g All hosts in the system are up and running Good One or more hosts in the system are in a warning state For instance a i8 loop may be down on an adapter in one of the hosts in the system Warning All hosts in the system are down Bad The SANsurfer FC HBA Manager window contains an FC CNA HBA tree tool tabs a title bar menu bar tool
129. on 4 15 default password location of 5 16 Details page Transceiver Details Diagnostics 6 10 Index 2 device Glossary 2 icons 5 11 sharing policy 5 24 diagnostic Glossary 3 diagnostics 6 1 adapter port to test finding 6 2 loopback connector installing 6 4 loopback test preparing for 6 3 running 6 6 normal adapter operations preparing for 6 4 preparing for 6 2 read write buffer test preparing for 6 5 running 6 6 tests running 6 1 transceiver details Details page 6 10 General page 6 8 viewing for adapter port 6 7 Diags button running adapter diagnostic tests Digital Diagnostics Monitoring Interface DDMI 6 7 disk configuration 2 12 icons 5 11 space requirements 3 2 downloading updates from Web 4 20 Driver Glossary 2 Driver File Details dialog box 7 11 driver parameters Linux 2 12 Macintosh 2 12 NetWare 2 13 drivers adapter settings specifying 5 29 enhanced driver installation 2 9 inbox NetWare 2 12 IP communications driver installing 2 12 RAID filter driver installation 2 10 required 3 2 SN0054651 00 F XX QLOGIC SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters I E EFI UTIL utility 2 9 e mail notifications setting up automatic 5 23 Email Settings dialog box 5 23 5 24 enhanced driver installation 2 9 environments 1 1 event IDs searching knowledge base for 7 2 event logging adapter events 5 21 Event Viewer saving tool log 7 19 eventlog txt fi
130. opens see SANsurfer FC HBA Manager Main Window on page 5 5 Starting SANsurfer FC HBA Manager on Macintosh NOTE If you want to connect to one or more specified hosts automatically when starting SANsurfer FC HBA Manager see Connecting to Hosts Automatically Linux Solaris or Macintosh CLI on page 5 4 On Macintosh systems follow these steps to start the SANsurfer tool which includes SANsurfer FC HBA Manager To start SANsurfer FC HBA Manager on Macintosh 1 Open Finder 2 Browse to the folder containing the installed SANsurfer tool 3 Double click the SANsurfer icon SANsurfer FC HBA Manager opens see SANsurfer FC HBA Manager Main Window on page 5 5 Connecting to Hosts Automatically Windows CLI On a Windows system follow these steps to connect automatically to one or more specified hosts when starting the SANsurfer FC HBA Manager user interface from the command line When done the SANsurfer FC HBA Manager main window appears with the specified hosts SN0054651 00 F 5 3 Getting Started pad Starting SANsurfer FC HBA Manager QLOGIC ee To connect to a host automatically on Windows 1 From a Windows system click the Start button point to Programs point to Accessories and then click Command Prompt The Command Prompt window opens Change to the directory where the SANsurfer tool is installed Do one of the following m To connect to the local host type the following and then pr
131. or port ID across reboots regard less of SAN configurations Glossary 6 WWPN World Wide Port Name A unique name assigned to a each port on a device One WWNN world wide node name may contain multiple WWPN addresses SN0054651 00 F Index A About box 5 15 access password changing 5 16 default 5 16 requirement for 5 16 adapter properties file 7 9 7 19 7 20 adapters 5 9 driver settings specifying 5 29 event log setting 5 21 event notifications setting 5 23 icons 5 10 port icons 5 10 port transceiver details viewing 6 7 supported versions 3 4 Add Remove Programs dialog box 4 26 4 32 adjunct driver Glossary 2 agent activity exporting 7 20 7 21 exporting Linux or Macintosh 7 19 agent logs 7 19 exporting 7 20 7 21 exporting Linux or Macintosh 7 19 saving from Event Viewer 7 19 AL PA Glossary 1 App Events button reviewing host events 5 7 5 8 Application Event Log options setting 5 20 service errors 7 1 Apply Properties to Shortcut dialog box 7 18 arbitrated loop Glossary 1 autoexec ncf file NetWare 2 11 SN0054651 00 F XX LOGIC The Ultimate in Performance B bandwidth 1 4 beacon Glossary 4 Boolean help system search 5 13 boot code Glossary 1 boot device Glossary 1 Broadcast Settings dialog box 7 5 Browse dialog box 5 2 browser location specifying for help 5 14 supported versions 3 2 Browser Location dialog box 5 14 buttons main toolbar 5 7 C CDM Glossary 2 CD ROM base
132. ors and so on For more information see the SANsurfer FC HBA Manager Application Help The Solaris agent logs events for significant driver errors In addition you can configure the Solaris agent to perform extended event logging for an adapter which causes it to log all loop transitions and many minor events Extended Application Event Logging uses extra overhead and is enabled only in troubleshooting situations The extended event logging flag is stored in the adapter parameters which you can modify using Fast UTIL Solaris SPARC FCode Solaris x86 or the SANsurfer FC HBA Manager The path for the Solaris messages file is var adm messages SANsurfer FC HBA Manager SANsurfer FC HBA Manager lists target devices on an adapter loop topology information loop error count information and so on SANsurfer FC HBA Manager shows target devices on an adapter and is useful for analyzing system configurations SANsurfer FC HBA Manager uses a feature of the enhanced miniport driver to find and display information about devices that are not configured on the local host This feature can display information about all potential target devices on a fabric or all devices on a loop topology not just those that are configured on the local host Troubleshooting Problems and Solutions This section provides troubleshooting problems and solutions Refer to the associated readme txt file for the latest problems and solutions see Related Documents
133. ort and contact information The remainder of the user s guide contains the following sections and appendices m Section 1 SANsurfer FC HBA Manager Overview describes the features of SANsurfer FC HBA Manager E Section 2 System Overview outlines the hardware and software installation of devices controlled by SANsurfer FC HBA Manager m Section 3 System Requirements lists the hardware and software requirements needed for optimum SANsurfer FC HBA Manager performance m Section 4 Installing SANsurfer FC HBA Manager describes how to install and uninstall SANsurfer FC HBA Manager SN0054651 00 F Xi XX QLOGIC AA NN m Section 5 Getting Started describes how to customize the SANsurfer FC HBA Manager It includes starting and exiting the SANsurfer FC HBA Manager user interface getting help setting security and setting the options that activate each time you start SANsurfer FC HBA Manager m Section 6 Performing Diagnostics provides details for setting up running and interpreting loopback and read write buffer tests as well as viewing adapter port SFF DMI information m Section 7 Troubleshooting presents common troubleshooting questions and answers It also provides the procedures for tracing the SANsurfer FC HBA Manager user interface and agent activity if directed to do so by your authorized service provider E Appendix A Frequently Asked Questions lists and provides the answers to frequently asked questions about SANsurfer F
134. osts The only limiting factor is that the SANsurfer FC HBA Manager Agent must be run on each host in turn m The RAID system offers eight LUNs numbered 0 7 The RAID system typically has its left and right controllers operating in an active active manner with half the LUNs available on each controller m Both hosts X and Y can recognize both targets on both adapters In SANsurfer FC HBA Manager each target device is configured with one adapter as its preferred path and optionally one adapter as its alternate path Ensure that both controllers are configured as enabled and not masked on a target level E Onhost X the LUN mask for both controllers is set to enable LUNs 0 3 and disable all other LUNs This LUN mask must be consistent for both the left and right controllers so that LUN alternates in the RAID system function correctly On host Y the LUN mask for both controllers is set to enable LUNs 4 7 and disable all other LUNs m The two alternate systems function independently based on the configuration operation of the RAID subsystem s LUN alternate and type of failure that occurs If access to a target controller is lost RAID subsystem LUN failover handles the recovery If access to a target controller is available on an alternate path adapter failover handles the recovery Installation Checklist Depending on the features you require this section describes the installation process step by step Note that your configuration m
135. owser program file The Browser Location dialog box shows the new browser path and file name 3 When you finish choosing your browser do one of the following m o save the browser location to the SANsurfer FC HBA Manager configuration file click OK m o close the Browser Location dialog box without making changes click Cancel 5 14 SN0054651 00 F XX Getting Started LOGIC Getting Help ls Viewing SANsurfer FC HBA Manager Tool Information The About box shows the product version number and QLogic copyright information To view information about SANsurfer FC HBA Manager 1 On the SANsurfer FC HBA Manager main window Help menu click About The About SANsurfer FC HBA Manager window opens Figure 5 4 About SANsurfer FC HBA Manager SANsurfer POWERED B Ya XA Q LO G C SAN surfer FC HBA Manager igh Availability Edition v5 0 1 Build 39 Copyright 2002 2008 QLogic Corp Remote command and control of QLogic Host Bus Adapters Figure 5 4 About SANsurfer FC HBA Manager Window This window provides the following information m High Availability Edition version number Copyright information 2 To close the About window and return to the SANsurfer FC HBA Manager main window click OK SN0054651 00 F 5 15 Getting Started pad Setting SANsurfer FC HBA Manager Security LOGIC E YA Setting SANsurfer FC HBA Manager Security SANsurfer FC HBA Manager security ensures that adapter configuration changes
136. perating parameters The Transceiver Details page contains two nested pages General and Details The General page Figure 6 1 shows an overview of the status data and inventory data from the optical transceiver device The Details page Figure 6 2 shows detailed digital diagnostic data from the optical transceiver device after running diagnostics per SFF 8472 Specification for Diagnostic Monitoring Interface for Optical Xcvrs Revision 9 3 August 1 2002 NOTE m The Transceiver Details page is available only for 4Gb or greater adapter devices m The Transceiver Details function is unavailable if you are using inbox drivers with Red Hat 5 0 or SLES 10 0 The following identifying information appears above the nested pages SN0054651 00 F Hostname is the name or IP address of the host connected to the adapter HBA Model specifies the model number for the adapter any ISP2422 2432 based adapter HBA Port indicates the adapter port number Node Name indicates the World wide adapter node name 6 7 Performing Diagnostics pad Viewing Adapter Port Transceiver Details LOGIC E Port Name indicates the World wide adapter port name Port ID indicates the Port ID of the adapter port General Page The General page Figure 6 1 of Transceiver Details contains two sections Media Information and Diagnostic Data General Diagnostics Transceiver Details Hostname n7112av5905hb1 1 0 3 2038 HBA Model QLA2460 HBA Port 1
137. pplication help from the main window point to the Help menu on the menu bar and click Browse Contents The application help opens in the browser you selected using the Set Browser Location option see page 5 14 The help window displays a navigation pane on the left and a topic pane on the right From the navigation pane select one of the following tabs to locate the information you want to display Q Contents Displays a list of topics organized by task much like the Table of Contents in this user s guide This list also includes book icons that open and close to show and hide topics related to the book title Click a closed book icon to open it and display its list of topics Click an opened book icon to close it and hide its topics Click the title of any book or topic to display its content in the topic pane Q Index Provides an alphabetically arranged list of key words To jump to a keyword start typing it in the text field Click any index entry to display a related topic in the topic pane If a keyword has more than one topic associated with it a pop up menu opens displaying a list of related topics you can select QO Search Provides access to all topics contained in the application help using advanced search capabilities Type one or more keywords in the text field then press ENTER The search tool lists all topics that meet your search criteria Select any topic to display its contents in the topic pane NOTE The sear
138. r device that has a speed of 400 MBps 400 uses a multimode 62 5 m M6 laser which is a shortwave laser without OCF SN for an intermediate distance 1 m Speed Indicates the data transfer rate for the transceiver device in Mbytes sec Diagnostic Data The Diagnostic Data section shows the existing Value Status High Alarm value High Warning value Low Warning value and Low Alarm value for the following data m Temperature C Temperature of the transceiver device in degrees centigrade Voltage V Voltage of the transceiver device power supply in volts Tx Bias mA Transmitting laser bias current in mA Tx Power mW Coupled transmitter output power of the laser in mW Rx Power mW Received optical power in mW The Value shows the existing number value for the datum The Status shows its rank as Normal Warning or Fault Normal status appears in a 9FEEN cell in the Diagnostic Data section Fault status appears in a IBM cell and warning status appears in a yellow cell A fault status requires immediate action Each datum has a High Alarm and a Low Alarm value If a datum exceeds the High Alarm value or falls below the Low Alarm value the conditions are likely to cause an inoperable link and require immediate action Additionally each datum has a High Warning value and Low Warning value Warnings indicate conditions outside the normally guaranteed bounds but are not necessarily causes for immediate link failures
139. r shared enabled LUNs among host s check box and then select one of the following policies 5 26 SN0054651 00 F XX Getting Started LOGIC Setting the Configuration Policies I TI QO Donot allow selected LUN to be enabled no LUN sharing allowed This policy does not enable the selected LUN If you select this policy and this type of sharing is detected a warning appears Do one of the following Q For your system to unconfigure the LUN click OK Q TO view which LUNs are being shared with hosts that are conflicting with this policy click More Configure the selected LUN s and disable access from other hosts This policy configures the selected LUN and disables access to the LUN from other hosts If you select this policy and this type of sharing is detected a warning appears Do one of the following L To disable access to these LUNs from other hosts that display in the FC CNA HBA tree click OK Q To disable this policy for this instance click Cancel Q To view which LUNs are being shared with hosts that are conflicting with this policy click More Q Enable the selected LUN and display a message if the LUN is already enabled on another host s This policy enables the selected LUN and shows a message if the LUN is enabled on another host If you select this policy and this type of sharing is detected a warning appears Do one of the following U To disable access to these LUNs from other hosts
140. ra Red Hat SUSE Linux or Solaris SPARC x86 system follow these steps a Open a shell b Change to the directory where you downloaded the SANsurfer installer Unzip the package if necessary Type the following command at a command prompt then press ENTER sh standalone sansurfer5 x xbxx linux install bin The InstallAnywhere window prepares to install SANsurfer and opens the installation Introduction dialog box Figure 4 2 Pila E3 Introduction T SANsurfer itis strongly recommended that you quit all programs before continuing with this SANsurfer installation POWERED BY xX OLOGIC You may cancel this installation at any time by clicking the Cancer button installAnywhere by Macrovision Cancel Figure 4 2 Install SANsurfer Introduction 3 Click Next SN0054651 00 F 4 5 Installing SANsurfer FC HBA Manager pad Initial Installation QLOGIC ee aaa The Important Information dialog box opens Figure 4 3 O SANsurfer iE Important Information SANsurfer POWERED BY IX oLoGic SANsuxfer Application Notes Section 1 SANsurfer FC HBA Manager Application Notes Fibre Channel HBA QLx2xxx QLx2xx Section 2 SANsurfer Switch Manager Application Notes Section 3 SANsurfer iSCSI HBA Manager Application Notes iSCSI HBA QLA4xxx Section 1 SANsurfer FC HBA Manager Application Notes Fibre Channel HBA QLx2xxx QLx2xx x 1 Par imfnrmntinm am 3a al iani an installAnywhere b
141. rameters 2 13 SN0054651 00 F v SANsurfer FC HBA Manager User s Guide pad Management Tool for QLogic FC and FCoE Adapters LOGIC AA NY 3 vi System Requirements Hardware Requirements 3 1 Software Requirements 3 2 Supported QLogic Adapters 3 4 Installing SANsurfer FC HBA Manager Initial Installation 4 1 Installation Options 4 2 Installation Instructions 4 3 Installation Instructions Using CLI 4 17 WINdOWS 7 nana cae Ded ed een Ka bei ee Chea bag saw Lag 4 18 LINUX 2 teas caw dee hare KK AE MULE GR a KKK Ra WA 4 18 ke Ta AA Baa AN ead ede Rite tal dead kid We ae de Beets 4 18 Installation Instructions for VMware ESX 3 5 4 19 Web and CD Based Installation Updates 4 20 Updating SANsurfer by Web Update 4 20 Network Does Not Use Proxy Settings 4 21 Network Requires Proxy Settings 4 21 Updating SANsurfer by Package Update 4 23 Uninstalling SANsurfer 4 26 Getting Started Starting SANsurfer FC HBA Manager 5 1 Starting SANsurfer FC HBA Manager on Windows
142. run the SANsurfer FC HBA Manager user interface mM QLogic QLA2xxx drivers as appropriate Windows XP Professional Windows 2000 Windows Server 2003 Windows Vista Windows Server 2008 NetWare Linux Solaris Mac OS X m TCP IP protocol for Windows 2000 Windows Server 2003 remote management OOOUOOOCOOD TCP IP protocol for NetWare remote management Java SE Development Kit JDK 1 5 0 on all platforms except Linux PPC 64 Linux IA64 and Solaris SPARC Administrative privileges to perform management functions To view the help system use the most current released version of one of the following Web browsers Internet Explorer Netscape Communicator or Mozilla Firefox One of the following operating systems Q Windows Windows 2000 32 bit Intel x86 Intel 64 AMD64 Windows Server 2003 32 bit Intel x86 Intel 64 AMD64 Windows Server 2008 32 bit Intel x86 Intel 64 AMD64 Windows XP Professional 32 bit Intel x86 Intel 64 AMD64 Windows XP Professional x64 bit Intel 64 AMD64 Windows Vista 32 bit Intel x86 Windows Vista x64 L Solaris 3 2 SN0054651 00 F XX System Requirements LOGIC Software Requirements OO aaa a m Solaris 9 10 x86 32 bit 64 bit Intel x86 Intel 64 AMD64 m Solaris 2 6 7 8 9 and 10 SPARC 32 bit 64 bit SPARC Oh NetWare m Netware 6 5 32 bit Intel x86 Intel 64 AMD64 QO Apple Macintosh m Mac OS X Tiger Leopard 32 bit 64 bit PowerPC Intel C
143. rver fully qualified name gt Port 8080 Login lt user name Password eee OK Cancel Figure 4 17 Update SANsurfer Server Proxy Settings Dialog Box 4 Ifyou want the HTTP proxy setting to be detected automatically leave the dialog box as is and then click OK to continue If you want to specify the server proxy settings complete the following a Select the Use the following HTTP proxy setting check box b In the Address box type the http address SN0054651 00 F 4 21 Installing SANsurfer FC HBA Manager IK Web and CD Based Installation Updates LOGIC ee In the Port box type the port ID of the proxy server d In the Login and Password boxes type your login and password for the proxy servers that require authentication e To continue click OK To exit the dialog box and return to the main SANsurfer FC HBA Manager window click Cancel When your computer accesses the Internet the Update dialog box appears Figure 4 18 showing available update information 2 0 30b85 2 0 30b84 Critical Update Status Pending Size 21 9MB Description SANsurer SANsurfer FC HBA Manager General application update Figure 4 18 Update SANsurfer Update Dialog Box The available update information includes E Current Updates column lists product updates available for the current tool version E Selected Updates column lists product updates that you select for ins
144. s field service personnel and customers who are installing QLogic hardware and the SANsurfer FC HBA Manager tool This section assumes that you are familiar with the hardware installation and operating systems where you are installing the adapters Configurations This section illustrates and describes the following system configurations m Single Ported Non failover Configuration on page 2 2 Simple Failover Configuration on page 2 3 SAN or Cluster Configuration on page 2 4 RAID Configuration and LUN Masking on page 2 5 SN0054651 00 F 2 1 System Overview pad Configurations QLOGIC LL LLL z Single Ported Non failover Configuration Figure 2 1 shows a simple single ported non failover configuration consisting of one host X two adapters A and B and ten target devices 0 9 This configuration assumes that the host has access to all connected devices therefore it requires an adapter operating system driver but does not require the rest of SANsurfer FC HBA Manager Other SANsurfer FC HBA Manager components help manage devices more easily Adapter 0 O O O Oka Adapter Host X Target 6 7 Devices Figure 2 1 Single Ported Non failover Configuration This illustration simplifies hardware connections target devices connect through a local loop FC hub FC switch or any combination of those FC topology is useful in troubleshooting
145. s then each host is configured to recognize a different set of devices This configuration can be made at the target device level called target masking where host X is configured to see devices 0 1 and mask devices 2 4 and host Y is configured to see devices 2 4 and mask devices 0 1 Alternatively this configuration can be made at the logical unit number LUN level called LUN masking where hosts X and Y recognize the devices but each has a different set of LUNs masked on the device If Figure 2 3 represents a cluster of two hosts then the hardware setup is the same however for the software configuration each host is configured to recognize the same set of devices Cluster software must determine arbitrate which host accesses which devices at any time For example both hosts can be configured to recognize all targets but cluster software determines that host X is the preferred host and owns the devices unless cluster software determines that host X is down and host Y takes over 2 4 SN0054651 00 F XX QLOGIC System Overview Configurations RAID Configuration and LUN Masking Figure 2 4 illustrates the interaction of an adapter alternate with a LUN alternate in a RAID subsystem Two hosts X and Y connect to a fabric which is simplified for this diagram Also on the fabric is a RAID subsystem with dual controllers left and right containing eight LUNs Host X Adapte LUNs 0 3 7 7 Fabric
146. s Now The Select Update dialog box opens Figure 4 16 Select Update O From the QLogic website Browse Lo Continue Cancel L J J Figure 4 16 Update SANsurfer Select Update Dialog Box 4 20 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Web and CD Based Installation Updates I aaa 2 Depending on whether or not your network requires proxy settings follow the appropriate procedure 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 1 On the Select Update dialog box Figure 4 16 click From the QLogic website Clear the Specify Proxy Settings check box Click Continue If updates are available the Update dialog box opens Figure 4 18 Otherwise a message box informs you that there are no updates Network Requires Proxy Settings Follow these steps to update SANsurfer from the QLogic Web site when your network requires proxy settings to access the Internet To update SANsurfer network requires proxy settings 1 On the Select Update dialog box Figure 4 16 click From the QLogic website Select the Specify Proxy Settings check box Click Continue The Server Proxy Settings dialog box opens Figure 4 17 Server Proxy Settings v Use the following HTTP proxy setting Address lt se
147. s you to connect to and disconnect from local and remote hosts It also provides information about connected hosts and their attached QLogic adapters with connected storage devices Also the current SAN configuration is rendered in an easy to view two dimensional drawing for a specific host m SAN configuration management SANsurfer FC HBA Manager allows you to configure local and remote systems With SANsurfer FC HBA Manager you can Q Configure QLogic Fibre Channel adapters and converged network adapters Q Configure FC target devices Q Compare hosts This feature allows you to view the differences between the current host and any saved host configuration so you know what has changed in the SAN Uu Configure LUNs for a device load balancing Q Configure LUN path failover 1 2 SN0054651 00 F XX SANsurfer FC HBA Manager Overview QLOGIC Features ls U Persistently bind targets The adapter driver binds a target ID using a target s world wide port name WWPN or port ID enabling the target ID to always connect to the WWPN or port ID across reboots regardless of SAN reconfigurations CL Update the adapter parameters Flash and adapter driver NOTE You can install the adapter driver before you install the adapter hardware m Statistics SANsurfer FC HBA Manager provides statistics for each host and adapter port These statistics can be collected automatically or on request You can reset statistics at any time
148. saving any changes click Cancel Setting Application Event Log Options Follow these steps to set the maximum number of events the Application Event Log can list and the types of logging events recorded NOTE See the SANsurfer FC HBA Manager Application Help for information about Viewing the Application Event Log To set event log options 1 To access the Options dialog box choose one of the following methods m On the SANsurfer FC HBA Manager main window open the Settings menu and then click Options E Right click the FC CNA HBA tree and then on the shortcut menu click Options m Press CTRL SHIFT T 5 20 SN0054651 00 F XX Getting Started QLOGIC Setting the HBA Event Log Option ls The Options dialog box opens Figure 5 8 App Event Log The size of the event log can be set from 20 to 200 events Log Size 20 Iv Log Informational Events VI Log Warning Events Figure 5 8 Options Dialog Box App Event Log 2 Under App Event Log type the number of events that the event log can list in the Log Size box The range is 20 to 200 events the default is 20 events 3 Ifyou want to enable logging of informational events select the Log Informational Events check box 4 Ifyou want to enable logging of warning events select the Log Warning Events check box 5 When you finish making selections do one of the following m To save the changes and close the Options dialog box click OK m To
149. set the policies for sharing devices and LUNs among hosts A device or LUN is shared when more than one host in the FC CNA HBA tree has access to the device or LUN Only hosts that appear in the FC CNA HBA tree are checked for shared access to a device or LUN To set the configuration policies 1 To access the Policy Settings dialog box choose one of the following options m On the SANsurfer FC HBA Manager main window open the Settings menu and then click Policies m Press CTRL SHIFT P The Policy Settings dialog box opens Figure 5 11 5 24 SN0054651 00 F XX Getting Started LOGIC Setting the Configuration Policies xi Options for sharing devices among host s v Check for shared devices targets among hosts Do nat allow selected device to be configured no device sharing allowed gt Configure the selected device s and disable access from other hosts Configure the selected device and display a message if the device is already configured on another host s Ask these options when a device is configured and sharing is detected Options for sharing LUNs among host s Check for shared enabled LUNs among host s Do nat allow selected LUN to be enabled no LUN sharing allowed O Configure the selected LUN s and disable access from other hosts 9 Enable the selected LUN and display a message if the LUN is already enabled on another host s Ask these options when a LUN is Enabled and sharing is detect
150. situations however a basic configuration reguires only this simple diagram showing which hosts and adapters are connected to which target devices This is not a failover configuration each target device is accessible through only one adapter 2 2 SN0054651 00 F XX System Overview QLOGIC Configurations ls Simple Failover Configuration Figure 2 2 shows a simple failover configuration consisting of one host X two adapters A and B three dual ported devices 0 2 and two single ported devices 3 and 4 A Target DOO CO nika P A Host X P Preferred path A Alternate path Figure 2 2 Simple Failover Configuration In this configuration connections marked P are preferred paths to a device and connections marked A are alternate paths Alternate paths to devices are typically hidden from the operating system and file system layers to keep them from being interpreted as two distinct devices SN0054651 00 F 2 3 System Overview pad Configurations QLOGIC AA NN SAN or Cluster Configuration Figure 2 3 shows a simple storage area network SAN configuration consisting of two hosts X and Y Each host has an adapter that connects to a common set of five target devices 0 4 Adapter Host X Target Devices Host Y Figure 2 3 SAN or Cluster Configuration If Figure 2 3 represents a SAN of unrelated host
151. stalling SANsurfer FC HBA Manager pad Initial Installation LOGIC O SANsurfer SANsurfer IX OLoGiCc Figure 4 11 Install SANsurfer Installing SANsurfer If you are installing NetWare the Novell NetWare Disk Selection dialog box opens Figure 4 12 Novell Netware Disk Selection Select the autodetected Netware SYS drive SANsurfer and or enter in a custom SYS drive letter to install the Novell Netware Agent POWERED BY XX LOGIC CN Fa C Enter Drive Letter fc Installanywhere by Zero G cancel Previous Next Figure 4 12 Install SANsurfer Novell NetWare Disk Selection 4 14 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Initial Installation TO The Novell NetWare Disk Selection dialog box lists the auto detected Windows drives mapped to NetWare server system volumes sys 11 Select the Windows drives on which to install the NetWare agent Each drive must be mapped to a NetWare server system volume sys a As appropriate select one or more auto detected drives In Figure 4 12 for example H N and Q can be selected N and Q are selected b Ifa Windows drive that you want to select has not been mapped to the NetWare server system volume do the following m Leave the Novell NetWare Disk Selection dialog box open To map the Windows drive to the NetWare Server system volume sys 1 open Windows Explorer point to Tools and then click Map Network Dr
152. tallation 5 To use the Update dialog box select the current product update packages m o select a package select its entry in the Current Updates list and then click Add gt gt The update moves to the Selected Updates list E To remove a package in the Selected Updates list select it and click lt lt Remove The selected package returns to the Current Updates list 4 22 SN0054651 00 F XX Installing SANsurfer FC HBA Manager LOGIC Web and CD Based Installation Updates I aaa For each update selected the following information is shown m Status describes the current status of the selected update m Size indicates the size of the selected update in MBs HR Description provides a general description of the update 6 When you finish selecting updates click Update to start the download and installation process Follow the instructions to install the selected product update Or to discontinue the update process and stop the installation click Cancel Updating SANsurfer by Package Update You can update SANsurfer FC HBA Manager by browsing to an existing update package on your hard drive or some form of external media such as a CD ROM DVD or portable storage device CAUTION You must exit SANsurfer to avoid locked files during the update process To update the existing tool 1 On the SANsurfer FC HBA Manager main menu click Help and then click Check for Updates Now The Select Update dialog box opens Figure 4
153. th stand alone and network configurations see Installation Options on page 4 2 5 Select one of the following installation sets and then click Next m For a Windows system Q FC HBA GUI and Agent includes the SANsurfer FC HBA Manager and the FC Windows agent u SANsurfer HBA NetWare 5 6 x includes the SANsurfer FC HBA Manager Novell NetWare 5 6 x and above agent Q Custom includes a modified installation set that you create QO SANsurfer Windows Agent includes the SANsurfer FC HBA Manager Windows 2000 2003 XP Vista Agent SANsurfer FC HBA Manager includes the SANsurfer FC HBA Manager user interface only SN0054651 00 F 4 7 Installing SANsurfer FC HBA Manager pad Initial Installation LOGIC CA ee E Fora Red Hat SUSE Linux system m m m SANsurfer FC HBA Manager includes the SANsurfer FC HBA Manager user interface only All GUIs and ALL Agents includes all user interfaces including SANsurfer FC HBA Manager and its agents Custom includes a modified installation set that you create m Fora Solaris SPARC x86 system m m m SANsurfer FC HBA Manager includes the SANsurfer FC HBA Manager user interface only All GUIs and ALL Agents includes all user interfaces including SANsurfer FC HBA Manager and its agents Custom includes a modified installation set that you create m Fora Macintosh system Figure 4 5 m m 4 8 FC HBA GUI and Agent includes the SANs
154. that the adapter does not have synchronization cable disconnected connection mode set incorrectly and so on HR Adapter status Indicates a status such as a severe critical alarm loop down warning alarm or good no alarm For information about alarms see Viewing and Managing the Adapter Event Log in the help system Examples 7 HBA QLA2342 QLogic s HBA Warning HBA QLA2342 Good SN0054651 00 F 5 9 Getting Started pad SANsurfer FC HBA Manager Main Window LOGIC e H H4 La 77 qrrrr m Adapter icons Good No alarm y Warning Warning alarm sf Loop Down No synchronization Bad Bad alarm wa Offline Adapter on offline host Adapter Port Icons and Text The FC CNA HBA tree lists the following information about adapter ports m Adapter port number For example Port n or for QLE8042 adapters also FCoE Engine Adapter port alias User defined alias name if assigned For more information see Displaying Adapter Port Information in the help system m Beacon flashing Flash Adapter Port Beacon Port LED flashing is enabled For more information see Finding an Adapter Port in the help system Adapter status Indicates status such as bad alarm loop down warning alarm or good no alarm For information about alarms see Viewing and Managing the HBA Event Log in the help system Examples 2 Port 0 Marketing s HBA port Good Beacon Flashing Ei Port
155. tion On Windows Linux IA32 x64 systems before installing the device driver verify the presence of adapters at power up using the QLogic Fast UTIL FC adapter BIOS utility To access Fast UTIL press ALT Q or CTRL Q during power up Fast UTIL allows you to perform basic adapter configuration Fast UTIL can verify device connectivity for loop and hub topologies but does not find devices on fabric configurations Verification On Windows Linux IA64 systems before installing the device driver verify the presence of adapters at power up using EFI UTIL Verification On Solaris SPARC Linux PPC 64 systems before installing the device driver verify the presence of adapters at power up using FCode utility Step 3 Install the Enhanced Driver Refer to the appropriate software installation guide see Related Documents on page 1 4 and readme txt file to install an enhanced device driver on host systems NOTE E Some operating systems such as Windows come from the operating system manufacturer with a QLogic miniport device driver This device driver is a standard driver and does not contain the extended features required to run with the SANsurfer FC HBA Manager You must install the most current device driver to support features such as LUN masking and failover To download the most current device driver versions go to the QLogic Support Center Web page support glogic com m Macintosh systems do not use failover
156. tion enabling 5 18 Web browser specifying for help 5 14 supported versions 3 2 web_supported_update_fc_hba txt file 4 24 Web based tool updates 4 20 what s in this guide xi window viewing main 5 5 Windows connecting to hosts automatically 5 3 event log 7 1 starting SANsurfer FC HBA Manager on 5 2 WWPN adapter driver settings 5 29 5 32 Index 7 SANsurfer FC HBA Manager User s Guide pad Management Tool for QLogic FC and FCoE Adapters LOGIC AA NY Notes Index 8 SN0054651 00 F XX QO LO G C Corporate Headquarters QLogic Corporation 26650 Aliso Viejo Parkway Aliso Viejo CA 92656 949 389 6000 www qlogic com The Ultimate in Performance Europe Headquarters QLogic UK LTD Quatro House Lyon Way Frimley Camberley Surrey GU16 7ER UK 44 0 1276 804 670 2009 QLogic Corporation Specifications are subject to change without notice All rights reserved worldwide QLogic and the QLogic logo are registered trademarks of QLogic Corporation 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 QLogic Corporation assumes no responsibility for any errors in this brochure QLogic Corporation reserves the right without notice to make changes in product design or specifications XX QLOGIC 4 3 4 4 4 5 4 6 4 7 4 9 4 10 4 11 4 12 4 13 4 14 4 15 4 16 4 17 4 18 4 19 4 20 4 21 4
157. to the FC connector on the adapter You must set the adapter parameter extended firmware Connection Options to 0 Loop Only For details see Preparing for the Loopback Test on page 6 3 Cause The device does not support SCSI Read Write Buffer com mands Solution Not all devices support the SCSI Read Write Buffer com mands The read write buffer test reports Unsupported if the device does not support these commands SN0054651 00 F Troubleshooting pa Verifying that the Adapter Driver is Installed LOGIC Ce Table 7 3 Troubleshooting Functional Issues Continued Problem Cause and Solution Current Path dialog box does Cause The glremote agent has not detected the saved configuration not display my saved configu Solution The Current Path dialog box shows the current configuration ration detected by the qlremote agent Click the Refresh button to force a manual refresh Verify that the configuration saved is the current config uration This includes the following no failover occurred no device was removed and the FC CNA HBA tree shows the appropriate device port name and LUN information Current Path dialog box does Cause The qlremote agent is unable to detect or communicate with not display my storage device the devices port names and LUNs Solution Verify that the devices are online and operational Verify that the operating system driver detects and communicates with the devices Click the Refr
158. tribution list SN0054651 00 F 1 3 SANsurfer FC HBA Manager Overview pad Advanced Features LOGIC AEE HWHHAAAAAAAAAAAAATAAAWM TY Wizards SANsurfer FC HBA Manager provides several easy to use configuration wizards Each wizard provides a set of dialog boxes that walk you through the steps required to configure and update Fibre Channel devices Advanced Features SANsurfer FC HBA Manager adds the following advanced features to its toolset N Port ID Virtualization NPIV NPIV N Port ID Virtualization allows you to make the most of your server and Fibre Channel fabric For instance you can partition your server to support multiple operating systems at the same time maximizing server utilization By creating virtual ports from a single physical adapter port you allow multiple initiators SANsurfer FC HBA Manager facilitates creating multiple virtual ports from a single physical adapter port It also lets you view virtual port statistics in real time NOTE NPIV is available for Windows operating systems and 4Gb and greater adapters only Quality of Service QoS QoS refers to Service Level Agreement SLA to ensure business continuity when transmitting data over virtual ports by setting priorities and allocating bandwidth The SANsurfer FC HBA Manager provides an easy to use interface that lets you assign QoS to virtual ports by setting priorities or allocating bandwidth to them m Setting the QoS by bandwidth lets you
159. u can hide the toolbar by pointing to the View menu and clicking Toolbar The check mark next to Toolbar clears and the toolbar becomes hidden To restore the toolbar click Toolbar again The check mark next to Toolbar appears and the toolbar itself reappears SN0054651 00 F XX Getting Started LOGIC SANsurfer FC HBA Manager Main Window Host Icons and Text The FC CNA HBA tree shows the following information about hosts m Host status Live or offline m Host name Host name or IP address For example hostname 10 3 13 90 m Host icons amp Online host The blinking heart on the host icon indicates that the connection between the user interface and the agent is active for this host An online host can be remote or local amp Indicates a remote host Indicates a local host amp Offline host The connection between the user interface and the agent is inactive for this host The configuration for this host can be loaded from a QLC file see Viewing a Saved Host Configuration from a File in the help system or a text file see Viewing a Saved Host Configuration from a Text File in the help system Adapter Icons and Text The FC CNA HBA tree shows the following information about adapters m Adapter model For example QLA2xxx or QLA2xxx 2xxx Adapter alias User defined alias name if assigned For more information see Displaying Adapter Information in the help system H Loop down Indicates
160. ues 7 4 7 2 Troubleshooting User Interface and Remote Agent Issues 7 5 7 3 Troubleshooting Functionallssues 7 8 A 1 Frequently Asked Questions A 1 B 1 SNOntCUt Koy AA B 1 SN0054651 00 F ix SANsurfer FC HBA Manager User s Guide pad Management Tool for QLogic FC and FCoE Adapters LOGIC Aa PP Notes x SN0054651 00 F XX LOGIC The Ultimate in Performance Preface The SANsurfer FC HBA Manager User s Guide describes the SANsurfer FC HBA Manager tool used to configure and manage QLogic SANsurfer Fibre Channel FC host bus adapters HBAs and Fibre Channel over Ethernet FCoE converged network adapters CNAs within storage area networks SANs NOTE Throughout this guide HBA and adapter are used interchangeably as are the terms target and device What s in this Guide This guide contains the basic information you need to get started with the graphical user interface GUI based SANsurfer FC HBA Manager management tool NOTE For detailed information about the features and functionality not covered in this guide refer to the help system see Getting Help on page 5 12 This preface explains the typographic conventions used in this guide lists related documents specifies the intended audience refers you to the QLogic license agreements and provides technical supp
161. urfer FC HBA Manager user interface and the FC Power Mac OS X agent SANsurfer FC Mac OS X Agent includes SANsurfer FC HBA Manager for the Power Mac OS X agent SANsurfer FC HBA Manager includes the SANsurfer FC HBA Manager user interface only All GUIs and ALL Agents includes all user interfaces including SANsurfer FC HBA Manager and its agents Custom includes a modified installation set that you create SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Initial Installation re eo SANsurfer FC HBA Manager J Choose Product Features FC HBA GUI and Agent This option instalis the SANsurfer FC HBA Manager GUI including the FC Power Mac POWERED BY OS X Agent XX oLosic SANsurfer eu SANsurfer FC Mac OSx Agent SANsurfer FC HBA Manager Power Mac OS X Agent SANsurfer FC HBA Manager ae This option installs the SANsurfer FC HBA Manager GUI only FC HBA Management GUI only Agent not installed Custom Choose this option for selection of individual components or a combination of components InstallAnywhere by Macrovision Cans C Figure 4 5 Macintosh Installation Choose Product Features The Choose Install Folder dialog box opens Figure 4 6 T SANsurfer O lt Choose Install Folder Where Would You Like to Install SANsurfer cxprogenriesiqionecoperstenisiasfer QLOGIC Restore Default Folder
162. wners Document Revision History Revision A February 2008 Revision B June 2008 Revision C November 2008 Revision D December 2008 Revision E January 2009 Revision F February 2009 i SN0054651 00 F XX QLOGIC SANsurfer FC HBA Manager User s Guide Management Tool for QLogic FC and FCoE Adapters ls Changes Sections Affected Revision B changes General edits Modified guide subtitle Modified product overview and features descrip tions Added VMware ESX to the software requirements Modified system overview introductory text Added support for QLE8042 converged network adapter CNA Removed support for combo installation Excluded Windows Vista and Windows 2008 Server from Windows shortcut profile and desktop icon creation Updated toolbar to show Stats button renamed Monitor Added FCoE engine icon Changed Linux Only to Linux Failover Driver Only Modified diagnostics introductory text Changed 23xx 24xx to 2xxx to indicate all sup ported 2000 series QLogic HBAs Most Management Tool for QLogic FC and FCoE Adapt ers 1 SANsurfer FC HBA Manager Overview Fea tures on page 1 2 Software Requirements on page 3 2 2 System Overview 1 Introduction Related Documents on page 1 4 Hardware Requirements on page 3 1 Sup ported QLogic Adapters on page 3 4 Initial Installation on pa
163. y Macrovision Cancel Previous Cra Figure 4 3 Install SANsurfer Important Information 4 Read the information and then click Next You can also find this information in the readme txt file in the following locations m On Windows Program Files Qhogic Corporation H On Red Hat SUSE Linux and Solaris SPARC x86 opt QLogic Corporation SANsurfer 4 6 SN0054651 00 F XX Installing SANsurfer FC HBA Manager QLOGIC Initial Installation ls The Choose Product Features dialog box opens Figure 4 4 NOTE Except for the OS specific agents the feature options are the same for all operating systems Windows Red Hat SUSE Linux Solaris SPARC x86 and Macintosh Ya SANsurfer FC HBA Manager Choose Product Features Mau FC HBA GUI and Agent f SANsurfer Windows Agent SAN surfer This option installs the SANsurfer FC E SANsurfer FC HBA Manager Windows POWERED BY HBA Manager including the FC 2000 2003 XP Vista Agent XX OLOGIC Windows Agent SANsurfer HBA Netware 5 SANsurfer FC HBA Manager SANsurfer FC HBA Manager Novell sr This option installs the SANsurfer FC Netware 5 5 x and Above Agent HBA Manager GUI only FC HBA Management GUI only Agent not installed Custom Choose this option forselection of individual components ora combination of components InstallAnywhere by Macrovision Cancel Previous N Figure 4 4 Install SANsurfer Choose Product Features SANsurfer FC HBA Manager supports bo

Q-Logic MP3 User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents