Emulex 3.3 manual

HBAnyware ® Utility V ersion 3.3 User Manual Last Updated November 29, 2007[...]

The HBAnyware Utility User Manual Page ii Copyright© 200 7 Emulex Corp oration. All rights reserved wo rldwide. No part of this document may be reproduced by any means nor translated to any electronic medium withou t the written consent of Em ul ex C orp oration. Information furnished by Emulex Corporation is believed to be accura te and reliable.[...]

The HBAnyware Ut ility User Ma nua l Pag e ii i Introduction .............................................................................................................. 1 Known Issues .................................................................................................... 1 Installing HBAnyware Components.............................[...]

The HBAnyware Ut ility User Ma nua l Pa ge iv Viewing and Setting Up Authentication (Windows, Solaris LPF C and Solaris SFS) ................................................................................. 36 Viewing or Changing Authentic ation Configuration ............................. 37 Changing Y our Password .................................[...]

The HBAnyware Ut ility User Ma nua l Pag e v Editing an ASG ......................................................................................... 93 About Offline ASGs ................................................................................... 94 Backup Masters ............................................................................[...]

The HBAnyware Utility User Manual Pag e 1 Introduction Emulex ® drivers have many properties that you can modify using the HBAnyware ® configuration utilit y . The utility is client/server based and provide s 're mot e ' configu ration capability to other host platforms running the utility . This remote configuration ca pabi lity can be[...]

The HBAnyware Utility User Manual Pag e 2 • If there are multiple versions of the Ja va Runtime En vironme nt (JRE) installed on your Internet Explorer client, then you may see th e following text in the browser 's main display win dow when you attempt to launch th e HBAnyware u tility via the bro wser: Emulex Corporation HBAnyware Demo of H[...]

The HBAnyware Utility User Manual Pag e 3 3. Unzip the file. T ype: gunzip HBAnyware-<version>-<platf orm>.tar.gz 4. Untar the file. T ype: tar -xvf HBAnyware-<version>-<pla tform>.tar 5. Run the pkgadd utility . T ype: pkgadd -d . 6. When prompted by pkadd, choose to install HBAnyware. 7. When prompted by pkadd, answer the [...]

The HBAnyware Utility User Manual Pag e 4 Inst alling the HBAnyware Utility with Web Launc h In addition to the driver and HBAnyware utilities, th e following must be inst alled before you can inst all the Web Launch feature: • In Windows: • Microsoft Internet Information Services (IIS) Server must be installed. See the Microsof t Web site for [...]

The HBAnyware Utility User Manual Pag e 5 6. Y ou are asked if your Web server is listening on the normal default HTTP port (80)? Answer Y or N as appropriate. If you answer N, you are prompted for the p ort you wish to use. Y ou are notified when the installation of the HBAnyware Web Launch package is complete. Once the necessary information is en[...]

The HBAnyware Utility User Manual Pag e 6 Uninst alling the HBAnyware Secu rity Configu rator T o uninstall the HBAnyware Security Configurator: In Windows: 1. Select St art>Settings>Control Panel . T he Control Pane l appea rs. Click on Add/Remove Programs and the Add or Remove Programs window ap pears. 2. Select Emulex HBAnyware Security Co[...]

The HBAnyware Utility User Manual Pag e 7 Uninst alling HBAnywar e W eb Launch Only T o uninstall HBAnyware Web Launch, but leave the HBAnyware utility installed: In Windows: 1. Select Start > Programs>Emulex>HBAnywar e WebLaunch Uninst all . The following screen appears: Figure 1: HBAnyware Web Launch, Uninstallation dia log screen 2. HBA[...]

The HBAnyware Utility User Manual Pag e 8 3. Uninstall any previously installed versions. T ype: ./uninstall Using the HBAnyware Component s St arting the HBAn yware Util ity T o start the HBAnyware utility: In Windows: On the Windows desktop, select St art>All Programs>Emulex>HBAnyware . If you have a Vista system, right-click and select [...]

The HBAnyware Utility User Manual Pag e 9 • If you are running the HBAnyware Security Configura tor with TCP/IP access, you must set u p any TCP/IP hosts or they will not be seen by the Security Configurator . T o start the HBAnyware Security Configurator: In Windows: On the desktop, click St art>All Programs>Emulex>HBAn yware Security C[...]

The HBAnyware Utility User Manual Page 10 The HBAnyware Utility Wind ow Element Definitions The utility window contains five basic componen ts: the menu bar , the toolbar , the discovery-tree, th e property tabs and the status bar . Figure 2: HBAnyware Utility window Note: The element you select in the discovery-t ree determine s whet her a menu it[...]

The HBAnyware Utility User Manual Page 1 1 The Menu Bar The menu bar contains command menus tha t enable you to perfor m a varie ty of tasks such as exiting the HBAnyware utility , resetting HBAs and sorting items in the discovery-tree view . Many of the menu bar commands are also availab le from th e toolbar . The T oolbar Many of the toolbar func[...]

The HBAnyware Utility User Manual Page 12 The Discovery-T ree The discovery-tree (left pane) has icons that repr esent discovered network (SAN) elements (local host name, system host names an d all HBAs active on each host). T ar gets and LUNs, when present, are also displayed. Figure 4: Discovery-tree Discovery-T ree Icons Discovery-tree icons rep[...]

The HBAnyware Utility User Manual Page 13 The T arget Controller LUN icon represents LUNs that are storage co ntrollers. The Switch icon represents connections to the switch. Property T abs The property tabs display configuration, statistical and status information for network elements. The set of available tabs is context-sensitive, dependin g on [...]

The HBAnyware Utility User Manual Page 14 2. Choose the managemen t type you want. 3. Click OK . In Solaris LPFC, Solaris SFS and Linux: 1. Run the following script: /usr/sbin/hbanyware/set_operating _mode 2. Choose the managemen t type you want. Resetting HBAs Y ou can re set remote a nd local HBAs. T o reset the HBA: 1. In the discovery-tree, sel[...]

The HBAnyware Utility User Manual Page 15 Figure 7: Di scov ery I nf or mation Remote SAN Management Us ing TCP/IP Access Protocol Y ou can also discover HBAs on TCP/IP hosts. Re mote SAN managem ent over TCP/IP send s remote management requests on another LAN u sing TCP/IP a ccess protocol to re mote hosts. TCP/IP access enables you to access HBAs[...]

The HBAnyware Utility User Manual Page 16 1. From the Discovery menu, select TCP/IP>Add Host . The Add Remote Host dialog box appears. Figure 8: Add R em ot e H ost d ial og box 2. Enter the name or the IP address o f the host to be a dded. Entering the IP add ress is the best way to add a new host. 3. Click OK . Y ou will receive a message indi[...]

The HBAnyware Utility User Manual Page 17 3. Click St art Disco very . The utility checks each add ress in the range to de termine if the host is available and remotely m anageab le. The number o f addresses discovere d (of mana geable hosts) is periodically updated on the dialog box. 4. Save the IP ranges. In Windows: A dialog box appears asking y[...]

The HBAnyware Utility User Manual Page 18 Configuring Discovery Settings Use the HBAnyware Discovery Settings dialog box to configure se veral discovery server parameters. Y ou can define when to start the discovery server , when to refresh FC and TCP/IP accessed discoveries and when to remove previo usly disco vered HBAs that a re no lo nger being[...]

The HBAnyware Utility User Manual Page 19 Sorting HBA Information Y ou can sort discovered HBAs by host name, fabric ID, HBA name , target name and L UN number . Y ou can also view local or remote HBAs. By default, both local and remote HBAs are sorted by host name. T o sort HBAs: 1. Switch between host name or fabric ID in one of two ways: • Fro[...]

The HBAnyware Utility User Manual Page 20 V iewing HBA Information Viewing Discovery Information Discovery Information co ntains a general summary of the disco vered elements. The Host or Fabric icon, depending upon which view you select, is the r oot of the discovery-tr ee, but it do es not r epresent a specific network element. Expanding it revea[...]

The HBAnyware Utility User Manual Page 21 Viewing Host Information There are two tabs that show host informatio n: the Host Inform ation tab and the Drive r Param eters tab. The Host Information tab is read-only . The Driver Parameters tab enables you to view and d efine HBA driver settings for a specific host. T o view the Host Information and Dri[...]

The HBAnyware Utility User Manual Page 22 The Driver Parameters T ab The Driver Parameters tab enables you to view and edit the HBA driver settings contained in a spe cific host. The host driver parameters are global values and ap ply to all HBAs in that h ost unless they are overridden by parameters assigned to a specific HBA using th e HBA Driver[...]

The HBAnyware Utility User Manual Page 23 Viewing General HBA Attributes The General tab contains general attributes associated with the selected HBA. T o view general attributes: 1. Select Host or Fabric sort. 2. Select an HBA in the discovery-tree. Figure 14: Genera l tab General Field Definitions Adapter Summary Area • Model - The complete m o[...]

The HBAnyware Utility User Manual Page 24 • The “Operational” state indicates that th e HBA is connected to the network and op erating normally . • All other states indicate that the HBA is not connected to the netwo rk. Green HBA icons with red descriptive text indicate that the HBA is offline. These offline st ates are: • “User offlin[...]

The HBAnyware Utility User Manual Page 25 • Discovered Ports - Counts the number of mapped and unmappe d ports found during discovery by the Emulex HBA driver . The mapped ports are targets and the unmapped ports are non target s such as switches or HBAs. • Device ID - The HBA's default device ID. Port Attributes Area • Port FC ID - The [...]

The HBAnyware Utility User Manual Page 26 Vi ewing Fabric Informa tion Discovery Information contains information ab out the sele cted fabric. T o view the fabric information: 1. Do one of the following: • From the menu bar , click Vi e w , then click Sort by Fabric ID . • From the toolbar , click th e Sort by Fabric ID b utton: . 2. Click on a[...]

The HBAnyware Utility User Manual Page 27 Viewing T arget Information T arget Information contains information specific to the selected stora ge device. T o view target information: 1. Do one of the following: • From the menu bar , click Vi e w , then click S ort by Host Name . • From the toolbar , click th e Sort by Host Name button: . 2. Clic[...]

The HBAnyware Utility User Manual Page 28 Viewing LUN Information LUN Information contains details about the selected LUN. T o view the LUN information: 1. Do one of the following: • From the menu bar , click Vi e w , then click S ort by Host Name . • From the toolbar , click th e Sort by Host Name button: . 2. Select a LUN in the discovery-tre[...]

The HBAnyware Utility User Manual Page 29 Masking and Unmasking LUNs (Windows, Solaris L PFC and Solaris SFS) LUN masking refers to wheth er or not a LUN is visible to the op erating system. A LUN that h as been masked is not available and is n ot visible to the OS. Y ou can use HBAnyware to ma sk or unmask LUNs at the host level. Figure 19: LU N M[...]

The HBAnyware Utility User Manual Page 30 T o change the mask status of a LUN: 1. From the discovery-tree, click on a SCSI target. A set of LUNs appears below the selected SCSI target. The LUN Masking tab is displayed. This tab contains a list of the same set of LUNs appear below the SCSI target. Figure 20: LU N Masking tab 2. In the LUN list of th[...]

The HBAnyware Utility User Manual Page 31 Viewing Port S tatistics The S tatistics t ab provides cumulative totals for various error even ts and statistics on the port. Some statistics are cleared when the HBA is reset. T o view port statistics: 1. Select Host or Fabric sort. 2. Select an HBA in the discovery-tree. 3. Click the Stati st ic s tab. F[...]

The HBAnyware Utility User Manual Page 32 • Link Transitions - The number of times the SLI port sent a link attention condition . • Elastic Buf Overruns - The numbe r of times the link interface ha s had its elastic buffer overrun. • Rx Frames - The number of FC frames re ceived by this HBA port. • Rx Words - The number of FC words received[...]

The HBAnyware Utility User Manual Page 33 Viewing Firmware Information Use the Firmware t ab to view current firmware versions, enable system BIOS and upda te firmware on remote and local HBAs. T o view the firmware information: 1. Select Host or Fabric sort. 2. Select an HBA in the discovery-tree. 3. Select the Firmware ta b . Figure 22: Firmware [...]

The HBAnyware Utility User Manual Page 34 Viewing T arget Mapping (Windows, Sola ris LPFC and So laris SFS) The T arget Mapping tab enables you to view curre nt target mapping an d to set up per sistent binding. T o view target mapping: 1. Select Host or Fabric sort. 2. Select the HBA in the discovery-tree whose target mapping in formatio n you wis[...]

The HBAnyware Utility User Manual Page 35 Vi ewing T arget Mapping (Li nux) Use this tab to view t arget mapping. The T arget Mapping t ab is read-only . T o view target mapping: 1. Select Host or Fabric sort. 2. Select the HBA in the discovery-tree whose target mapping in formatio n you wish to view . 3. Select the T arget Mapping tab. Figure 24: [...]

The HBAnyware Utility User Manual Page 36 Viewing and Setting Up Authentication (W indows, Solaris LPFC and Solaris SFS) Use the Authenticate tab to view and s et up FC-SP DHCHAP configuration. Y ou can initiate authentication asynchronously (at will) per HBA. O therwise, when authentication is ena bled, the HBA will attempt authentication with the[...]

The HBAnyware Utility User Manual Page 37 • Bi-Directional - If selected, the driver (HBA) supports authentication initiated by either (both) the switch or the HBA. If this check box is clear , th e driver supports HBA initiated authentication only . • Re-authenticate - If selected, the driver can p eriodically initiate authentication . • Re-[...]

The HBAnyware Utility User Manual Page 38 Up dating Firmware Y ou can u pdate firm ware on local and remote HBAs. T he firmware file must b e down loade d from the Emulex Web site and extracted to a local drive before you can perform this procedure . T o update firmware: 1. In the discovery-tree, select the HBA. 2. Select the Firmware ta b . Figure[...]

The HBAnyware Utility User Manual Page 39 5. Navigate to the extracted firm ware file you wish to download. Select the file and click Sta rt Download . A status bar shows the progress of the download and indicates wh en the downloa d is complete. 6. Click Close . The Firmwa re tab displays the up dated fir mware in forma tio n for the selected HBA.[...]

The HBAnyware Utility User Manual Page 40 6. Once downloading begins, the tree- view displa ys the pro gress. As firmware for a se lecte d HBA is being downloaded, it appears orange in the tr ee-view . Once successful downloading is complete, the entry changes to gre en. If the downloa d failed, the entry is changed to red. Figure 30: Firm ware Dow[...]

The HBAnyware Utility User Manual Page 41 Enabling or Disabling an HBA ’ s BIOS Enabling the BIOS is a two-step process: 1. Enable the HBA BIOS (x8 6 Boo tBIOS, F Code or EFIBoot) to read the Emulex boot code on the HBA. 2. Enable the HBA to boot from SAN (using the BIOS utility). The Emulex boot code must be down loaded from the Emulex Web site [...]

The HBAnyware Utility User Manual Page 42 Configuring the Driver In Windows, Solaris L PFC, Solaris SFS and Linux: Set dr iver parameters using the HBAnyware utility . In Solaris LPFC, Solaris SFS and Linux:, you can also specify parameters when loading the driver manually . Setting Driver Parameters The Driver Parameters t ab and host Driver Param[...]

The HBAnyware Utility User Manual Page 43 4. In the Driver Parameters tab, click the parameter that you want to change. A descriptio n of the parameter appears on the rig ht sid e of the tab. 5. Enter a new value in the V alue field in the same hexadecim al or decim al format as the curren t value. If the current value is in hexadecima l format, it[...]

The HBAnyware Utility User Manual Page 44 Setting Driver Parameters for a Host T o change the driver parameters for HBAs installed in a host: 1. Do one of the following: • From the menu bar , click Vi e w , then click Sort by Host Name . • From the toolbar , click th e Sort by Host Name button: . 2. In the discovery-tree, click the host wh ose [...]

The HBAnyware Utility User Manual Page 45 3. Unload the l pfcdfc dri ver . T ype: rmmod lpfcdfc 4. Unload the lpfc driver . T ype: rmmod lpfc 5. Reload the driver .T ype: modprobe lpfc modprobe lpfcdfc The HBAnyware services will st art automati cally when you laun ch the application. For these changes to persist after a reboot you must create a n [...]

The HBAnyware Utility User Manual Page 46 7. Click Save . The Save Driver Parameters dialog box appears. Figure 35: Save Driver Par amete rs dialog box 8. The two radio buttons allow you to choose the type of parameters to save. Y ou can save all parameters or only those parameters whose current values differ from their corresponding default values[...]

The HBAnyware Utility User Manual Page 47 Storport Miniport Driver Pa rameter Reference T ables The parameter values listed in T able 1 are applicab le to driver ver sion 2.00 or later . If you are using a version previous to 2.00, see the S torport Miniport Driver User Ma nual fo r parameter information. Activation Requirements A parameter has one[...]

The HBAnyware Utility User Manual Page 48 CoalesceRspCnt= n This parameter sp ecifies the number of response entries that trigge r an Interrupt response. V alue: 0 - 255 (decimal ) or 0x1 - 0xFF (hex) Default = 8 (0x8) Restart DiscoveryDelay= n DiscoveryD elay controls whether the driver wait s for ‘n’ seconds to start port discovery af ter lin[...]

The HBAnyware Utility User Manual Page 49 FrameSizeMSB= n FrameSizeMSB controls the upper byte of receive FrameSize if issued in PLOGI. This allows the FrameSize to be constrained on 256-byte increment s from 256 (1) to 2048 (8). V alue: 0 - 8 Default = 0 Restart HardALP A=0x n HardALP A allows the H BA to use a hard assigned loop address. V alue: [...]

The HBAnyware Utility User Manual Page 50 LogErrors= n LogErrors determine the minimum severity level req uired to enable entry of a logged error i nto the syst em event log. Errors are classi fied as severe, malfunction and command level. A severe error requires user intervention to correct a firmware or HBA problem. An invalid link speed selectio[...]

The HBAnyware Utility User Manual Page 51 PciMaxRead This parameter ena bles override of default PCI read transfer length. The driver will auto-detect the pres ence of an AMD PCI bridge and adjust for this bridge. This pa rameter allows for override of the automa tic value. V alue: 512, 1024, 2 048 and 4097 Default: 2048 Restart RmaDepth= n This pa[...]

The HBAnyware Utility User Manual Page 52 T raceBufSiz= n This parameter set s the size in by tes for the intern al d ri ver tra c e buffer . The internal driver trace buf fer acts as an inte rnal log of the driver's activity . V alue: 250,000 - 2,000,000 or 0x3 D090 - 0x1E8480 (hex). Default = 250,000 (0x3D090) Reboot T able 2: S torport Mini[...]

The HBAnyware Utility User Manual Page 53 Driver for Solaris LPFC – The Configuration File Refer ence T able The parameter values listed in T able 3 are applicab le to driver ver sio n 6.20i o r later . If you are using a version previous to 6.20i, see the Emulex Driver for So laris Use r Manual for parameter inform ation. The LPFC.conf file cont[...]

The HBAnyware Utility User Manual Page 54 auth-cfgp arms Controller S pecific Description and V alues: This is the DH-CHAP rela ted driver property for FC-SP support. It is only valid when dri v er property enable-auth is set to 1. This driver property should be igno red when enable-auth is set to 0. The format of this property is: "L WWN|RWWN[...]

The HBAnyware Utility User Manual Page 55 auth-keys Controller S pecific Description and V alues: This is the DH-CHAP au thentication key driver property for FC-SP support. It is o nly valid whe n driver prope rty enable-auth is set to 1. This driver property should be ignore d when enable-auth is set to 0. The format of this property is like: &quo[...]

The HBAnyware Utility User Manual Page 56 cr-count Controller S pecific 1 1 255 No This value specifies a coun t of I/O completions after which an interrupt response is generated. This feature is disabled if cr-de lay is set to 0. cr-delay Controller S pecific 0 0 63 No This value specifies a count of milliseconds after which an interrupt response [...]

The HBAnyware Utility User Manual Page 57 dqfull-throttl e-up- inc Controller S pecific 1 0 128 Y es Amount to increment LUN queue depth each time. This driver property causes the lpfc driver to decrement a LUN’s queue depth, if a queue full condition is received from the target. The queu e depth will be decremented down to a minimum of 1. The va[...]

The HBAnyware Utility User Manual Page 58 dqfull-throttl e-up- time Controller S pecific 1 0 30 Y es Time interval (seco nds) to increment LUN queue depth. Amount to increment LUN queue depth each time. This driver property causes the lp fc driver to decrement a LUN’ s queue depth, if a queue full condition is received from the t arget. The queue[...]

The HBAnyware Utility User Manual Page 59 enable-auth Controller S pecific 0 0 1 Y es This driver property specifies if the DH-CHAP is enabled or not. When set to 1, the you should also set up two other driver properties such as auth-cfgparms and auth-keys as described above. When set to 0, DH-CHAP support is disabled and auth-cfgpa rms and auth-ke[...]

The HBAnyware Utility User Manual Page 60 fcp-bind-method Controller S pecific 2 1 4 No Specifies th e method of binding to be used. This binding method is used for persistent binding and automapped binding. A value of 1 will fo rce WWNN bin ding, value of 2 will force WWPN binding and value of 3 will force DID binding. A fcp-bind- method value of [...]

The HBAnyware Utility User Manual Page 61 fcp-bind-WWPN Glob al Inactive N/A N/A No Setup persistent FCP bindings based on a targe t device’s WWPN. This binding guarantees that target assignments will be preserved between reboot s. The format for a bind entry is “NNNNNNNNNNNNN NNN:lpf cXtY” where NNNNNNNNNNNNNN NN is a 16 digit represent atio[...]

The HBAnyware Utility User Manual Page 62 linkdown-tmo Controller S pecific 30 0 255 Y es This variable controls how long the driver will hold I/O (0 - 255 seconds) af ter the link becomes inaccessible. When this timer ex pires, all I/O waiting to be serviced is aborted. For instance, FCP commands will be returned back to the target driver with a f[...]

The HBAnyware Utility User Manual Page 63 lpfcNtM-tgt-throttle Controller S pecific none 1 1024 0 No The maximum number of outst anding commands to permit for any target, incl uding all LUNs on that target. This value overrides tgt-queue- depth. lpfcXtYlZ-lun-mask Controller S pecific none 0 1 Y es The driver uses this value to determine whether or[...]

The HBAnyware Utility User Manual Page 64 msi-mode Controller S pecific 2 0 2 No This variable controls whether lpfc uses MSI based interrupt s or legacy interrupts. If set to 2 (default), the driver will try to use multiple message MSI. If multiple message MSI is not possible due to an OS or hardware limit ation, then the driver will attempt singl[...]

The HBAnyware Utility User Manual Page 65 nodev-tmo Controller S pecific 30 0 255 Y es This variable (0 to 255 seconds) co ntrols how long I/ O will be held by the drive r if a device on the SAN disappears. If set, I/O will be held for the specified number of seconds. If the device does not appear on the SAN before nodev-tmo seconds, then the drive[...]

The HBAnyware Utility User Manual Page 66 post-ip-buf Co ntroller S pecific 128 64 1024 No This variable specifies the number of 4K STREAMS buffers to all ocate and post to the fibre channel IP ring. Increase this setting for better IP performance under heavy loading. scan-down Controller S pecific 1 0=Off 1=On Y es There are two scanning algorithm[...]

The HBAnyware Utility User Manual Page 67 topology Controller S pecific 0x0 0x0=loop , then P2P 0x2=P2P only 0x4=loop only 0x6=P2P , then loop No This variable controls the Fibre Channel topology expected by lpfc at bo ot time. Fibre Channel offers point-to-point, fabric, and arbitrated loop topolo gies.T o make the adapter operate as an N_Port, se[...]

The HBAnyware Utility User Manual Page 68 Driver For Solaris SFS Parameters • The emlxs.conf file contains all the parameters necessary to initialize the Sola ris SFS drive r . • The HBAnyware utility reflects the Solaris SFS driver parameters. The parameter values listed in T able 4 are applicab le to driver ver sio ns 1.22/2.22 o r later . If[...]

The HBAnyware Utility User Manual Page 69 console-errors 0x00000000 0x00000000 0xFFFFFFFF Requires reboot. V erbose mask for error messages to the console. cr-count 1 1 255 Requires link reset. This value specifies a count of I/O completions after which an interrupt response is generated. This feature is disabled if cr-delay is set to 0. cr-delay 0[...]

The HBAnyware Utility User Manual Page 70 network-on 0 0 1 Requires reboot. Enables/disables IP networking support in the driver . num-iocbs 1024 128 10240 Requires HBA reset. This variable indicates the number of Input/ Output co ntr ol blo ck (IOCB) buffers to allocate. num-nodes 0 0 4096 Requires HBA reset. Number of FC nodes (NPorts) the driver[...]

The HBAnyware Utility User Manual Page 71 Solaris SFS and Solaris LPFC Driver Parameter Cross-Reference T able The cross-reference inform ation listed in T able 5 is applicab le to the Driver fo r Solaris LPFC version 6.20i and the Driver for Solaris SFS version 1 .22.2.223. If you are u sing a Solaris LPFC or Solaris SFS driver version previous to[...]

The HBAnyware Utility User Manual Page 72 console- notices Min : 0x00000000 Max:0xFFFFFFFF Default: 0x0000000 V erbose mask for notice messages to the console. log-verbose Min :0x0 Ma x: 0 x ffff Default:0x0 (bit mask) When set to nonzero this variable causes LPFC to generate additional messages concerning the state of the driver and the I/O operat[...]

The HBAnyware Utility User Manual Page 73 cr-count Min :1 Max:255 Default:1 Description: S pecifies a count of I/O completions after which an interrupt response is generated. This feature is disa bled if cr- delay is set to 0. cr-count Min:1 Max:255 Default:1 Description: S pecifies a count of I/O completions after which an interrupt response is ge[...]

The HBAnyware Utility User Manual Page 74 log-warnings Min: 0x00000000 Max:0xFFFFFFFF Default: 0x0000000 V erb ose mask for warning messages to the messages file. log-verbose Min :0x0 Ma x: 0 x ffff Default:0x0 (bit mask) When set to nonzero this variable causes LPFC to generate additional messages concerning the state of the driver and the I/O ope[...]

The HBAnyware Utility User Manual Page 75 num-iocbs Min:128 Max:1024 Default = 10240 Description: Sets the number of iocb buffers to allocate. num-bufs Min:128 Max:10240 Default = 256 Description: S pecifies the number of command buf fers to allocate. These buffers are used for Fibre Channel Extended Link Services (ELS) and one for each FCP command[...]

The HBAnyware Utility User Manual Page 76 topology 0 = loop, if it fails attempt pt- to-pt 2 = pt-to-pt only 4 = loop only 6 = pt-to-pt, if it fails attempt loop Default: 0 Description: Link topology for initializin g the Fibre Channel connection. Set pt- to-pt if you want to run as an N_Port. Set loop if you want to run as an NL_Port. topology 0x0[...]

The HBAnyware Utility User Manual Page 77 Driver for Linux, LPFC an d LPFCDFC Parameter T ables The driver parameter values listed in T able 3 are applicable to driver version 8.0 .16.34 or later . If you are using a version previou s to 8.0.16.34, see the Em ulex Driver for Linu x User Manual for parameter information The parameters determine some[...]

The HBAnyware Utility User Manual Page 78 * V ariable not tunable in HBAnyware. lpfc_link_speed 0 0=auto select 1=1G 2=2G 4=4G Sets link spee d. Y es lpfc_hba_qu eue_depth * 8192 32 8192 Maximum number of FCP commands that can queue to an Emulex HBA. Ye s lpfc_lun_q ueue_depth 30 1 128 Defa ult max commands sent to a single lo gical unit (disk). Ye[...]

The HBAnyware Utility User Manual Page 79 All lpfc dynamic parameters are read/write using sysfs. T able 7: Driver f or Linux, LPFC Dynamic Parameters (Do not require a driver reload to change) V ariable Default Min Max Comments lpfc_discovery_ min_wait * 3 0 60 The minimum number of seconds the driver wait s for the discovery to complete. lpfc_dis[...]

The HBAnyware Utility User Manual Page 80 Server Performance (Windows) I/O Coalescing I/O Coalescing is enabled and controlled by two driver parameters: CoalesceMsCnt and CoalesceRspCnt. The effect of I/O Coalescing will depend on the CPU resource s available on the server . With I/O Coalescing turned on, interrupts are batc hed, reducing the numbe[...]

The HBAnyware Utility User Manual Page 81 NumFcpContext If the number of outstanding I/Os per HBA is expected to exceed 512, increase this parameter to a value greater than the number of expected I/Os pe r HBA. Increase this value in stages: from 128 to 256 to 512 to 1024 to a maximum of 2048i. Num FcpContext limits the number of outstanding I/Os p[...]

The HBAnyware Utility User Manual Page 82 Mapping and Masking Automapping SCSI Devices (Windows) The driver defaults to automatically mapping SCSI d e vice s. The proce dures in th is section apply if the default has been changed. T o automap SCSI devices: 1. Display driver parameters for the host or HBA - sele ct the Dr iv er Param ete rs tab or t[...]

The HBAnyware Utility User Manual Page 83 Setting Up Persistent Binding (Windows , Solaris LPFC and Solaris SFS) Y ou can se t up persiste nt binding on rem ote a nd local HBAs. G lobal automap ping assigns a binding type, target ID, SCSI bus and SCSI ID to the dev ice. The binding type, SCSI bus and SCSI ID may change when the system is rebooted. [...]

The HBAnyware Utility User Manual Page 84 T o add a persistent binding: 1. In the T argets T able, click the target that you want to bind. 2. Click Add Binding . The Add Persistent Binding dialog box is displayed. Figure 38: Add Per sistent Binding dia log box 3. Select the bind type that you want to use (WWPN, WWNN or D_ID). 4. Select the bus ID a[...]

The HBAnyware Utility User Manual Page 85 Adding New T argets Usin g sd.conf for Solaris 8, 9 a nd 10 Y ou can p erform on- the-fly configur ation changes, wit hout rebo oting, using the HBAnyware u tility . For Solaris 8, you must first add the new targets to the sd.conf file. T o add new targets using sd.conf (Solaris 8): 1. Edit the Solaris SCSI[...]

The HBAnyware Utility User Manual Page 86 Creating the ACG T o create the ACG: 1. S t art the HBAnyware utility Security Configurator for the first time in an unsecure environment. A warning message appears. 2. Click OK . The Access Control Group tab appears: Figure 40: Access Co ntrol Group tab - No ACG Servers 3. Select the unsecured servers that[...]

The HBAnyware Utility User Manual Page 87 Designating a Master Security Client The first time you run the HBAnyware Security Config urator o n any system in a F ibre Channel netwo rk, that system becomes the MSC (Master Security Client). See “Running the Configurator for the First Ti m e ” on page 86 for more information. Access Control Groups [...]

The HBAnyware Utility User Manual Page 88 Access Control Group T ab on a Non-MSC On a non-MSC system, the Access Contro l Group tab shows the systems that are part of the client's ACG . Y ou can not mo dify the ACG on a non -MSC. (Y ou can m odify the ACG only on the M SC or a client higher in the security topology's hierar chy .) The ACG[...]

The HBAnyware Utility User Manual Page 89 Deleting a Server from the ACG T o delete a server from the Access Control G roup (ACG): 1. On the Access Control Group tab, from the Access Control Group Servers list, select the secured systems to delete from the ACG (Figure 42). 2. Click the right arrow to remove the servers from the Access Control Group[...]

The HBAnyware Utility User Manual Page 90 Access Sub-Group s Introduction Use the Access Sub-Group tab to crea te multiple Access Sub-Groups (A SGs) and multiple levels (tiers) in the security topology hierarchy . The hiera rchy can be as m any levels deep as d esired. Howe ver , we recommend the hierarchy extend no more than thr ee levels deep, as[...]

The HBAnyware Utility User Manual Page 91 Creating an ASG Create a new Access Sub- Group (ASG) by selecting one system from the Access Control Grou p (ACG) to be the client, and some or all of the other systems to be servers to this client, thus defining the new client's ACG . When the HBAnyware Security Con fig ur ato r is run on the new clie[...]

The HBAnyware Utility User Manual Page 92 Reserved Indices - Examples A particular security installation can support the creation of several hundred access grou ps (ACGs and ASGs). When you create each new acce ss group , you allocate so me numb er of 'indices' to the clie nt system of the new ASG . This number reflects the number of subs[...]

The HBAnyware Utility User Manual Page 93 Restoring an ASG to Its Last Saved Configuration Y ou can re store an Access Sub-Gr oup (ASG) to its last saved configuratio n if there are un saved changes to it. T o restore an ASG to its last saved configuration: 1. Click the Access Sub-Group tab (see Figure 45 on page 91). 2. Select the ASG whose config[...]

The HBAnyware Utility User Manual Page 94 About Offline ASGs Sometimes a client system may not be on line when the HBAnyware Security Con figu rator is r unning . In this case, the Access Sub-Group (ASG) for the client appears offline in the ASG tree, much like the following: Figure 48: Access S ub-Gr oups tab - Client S ystem Of fline The offline [...]

The HBAnyware Utility User Manual Page 95 Backup Masters Introduction A Backup Master mirrors the secu rity data of the Master Security Client (MSC) in case it has to take over as the MSC if the MSC is unable to ope rate or is re moved from the security co nfiguration . A Backup master system receives all the updates to the security configuration o[...]

The HBAnyware Utility User Manual Page 96 Creating a Backup Master T o create a Backup Master: 1. On the Master Security Client (MSC) , start the HBAnyware Security Co nfigurator . 2. Click the Backup Master tab. Figure 50: Ba ckup Master tab with Backup Masters 3. Select a system from the Available Systems list. 4. Click the lef t arrow to move th[...]

The HBAnyware Utility User Manual Page 97 Reassigning a Backup Master as th e New MSC from the Backup Master T o reassign a Ba ckup Master as the new MSC fro m the Backup Master: 1. On the Backup Master system that you want to reassign as the MSC, start the HBAnyware Security Configurator . 2. Click the Backup Master ta b . Figure 51: Backu p Mast [...]

The HBAnyware Utility User Manual Page 98 Diagnostics Performing Diagnostic T est s Use the Diagnostics tab to do the following: • Run these tests on Emulex HBA's installed in the system: • PCI Loopback (see page 102) • Internal Loopback (see page 102) • External Loopback (see page 102) • Power-On Self T est (POST) (see page 99) • [...]

The HBAnyware Utility User Manual Page 99 Running a Quick T est The Diagnostics tab enables you to run a quick diagn ostics test on a sele cted HBA. The Quick T est consists of 50 PCI Loopback test cycles and 50 Internal Loopback test cycles. T o run a quick test: 1. From the discovery-tree, sele ct the HBA o n which you wish to run the Quick T est[...]

The HBAnyware Utility User Manual Pag e 10 0 Creating Diagnostic Dump s The diagnostic dump featu re enables you to create a “dump ” file for a selected HBA. Dump files contain various information such as firmware version , driver version and so on, tha t is particularly useful when troubleshooting an HBA. T o start a diagnostic dump: 1. From t[...]

The HBAnyware Utility User Manual Pag e 10 1 Running Advanced Diagnostic T ests The Advanced Diagnostics fea ture gives you gre ater control than the Quick T est ov er the type of diagnostics tests that run. Through Advanced Diagnostics, you can specify which tests to run, the number of cycles to run and what to do in the event of a test failure. T[...]

The HBAnyware Utility User Manual Pag e 10 2 Running Loopback T est s T o run a loopback test, use the Loopb ack T est section of the Advanc ed Diagnostics dialog box. Loopback T est Combinations Run the following lo opback test com binations using the ap propriate che ck boxes: • PCI Loopback T est - A firmware controlled diag nostic test in whi[...]

The HBAnyware Utility User Manual Pag e 10 3 3. Click Start . The following warning appe ars: Figure 57: Advanced Diagnostic T ests Warning window 4. Click OK . If you choose to run an External Loopba ck test the following windo w appe ars: Figure 58: Adva nce d Diag nostic T ests Warning window f or Ext erna l Lo op ba ck 5. Click OK . The progres[...]

The HBAnyware Utility User Manual Pag e 10 4 All relevant information for the selected port is automatically added to the T arget Identifier sectio n of the Diagnostics dialog box. Figure 59: Se lect Echo T est T arget window 4. Click Start . The following warning wind ow appears: Figure 60: Advanced Diagnostic T ests Warning window 5. Click OK . A[...]

The HBAnyware Utility User Manual Pag e 10 5 T o save the log file: 1. After running a test from the Diagnostic T est Setu p dialog box, Click Save to File . The Select Diagnostic Log file Name dialog box app ears. The de fault name of a saved file is DiagT estLog.log. 2. Browse to the desired directory , change the log file na me if you wish a nd [...]

The HBAnyware Utility User Manual Pag e 10 6 Using the HBAnyware Utility Command-Line Interface The Command Line Interface (CL I) Client co mponen t of the HBAnyware utility pro vides access to the capabilities of the Remote Management library fro m a console com mand pro mpt. This componen t is intended for use in scripted op erations from within [...]

The HBAnyware Utility User Manual Pag e 10 7 ListHBAs Syntax: hbacmd ListHBAs Description: Shows a list of th e discovered manageable Emulex HBAs a nd some of their attrib utes. The list will contain one 6-attribute group for each discovered HBA. Parameters: None SaveConfig Syntax: hbacmd SaveConfig <WWPN> <FileName> <Flag> Descri[...]

The HBAnyware Utility User Manual Pag e 10 8 Ta r g e t M a p p i n g Syntax: hbacmd T argetMapping <WWPN> Description: Shows a list of mapped targets and the LUNs for the port. Parameters: WWPN - World Wide Port Name of the HBA whose target mapping you wish to view Reset Syntax: hbacmd Reset <WWPN> Description: Resets the HBA. An HBA r[...]

The HBAnyware Utility User Manual Pag e 10 9 GetLunUnMaskbyT arg et Syntax: hbacmd GetLunUnMaskByT arget <HBA WWPN> <T arg et WWPN> <Optio n> Description: Queries for the presence of any un masked LUNs by target. Parameters: HBA WWPN - World Wide Port Name of the HBA you wish to query T arget WWPN - World Wide Port Name of the tar[...]

The HBAnyware Utility User Man ual Page 1 10 PersistentBinding Syntax: hbacmd PersistentBinding <WWPN> <Source> Description: S pe cifies which set of persistent binding inform ation is requested : the configured o r live state of any present binding. Parameters: WWPN - World Wi de Port Name of the HBA whose persistent binding informatio[...]

The HBAnyware Utility User Manual P age 1 11 BindingCap abilities Syntax: hbacmd BindingCapabilities <WWPN> Description: Shows the binding capabilities present fo r the HBA. If a binding is con figured , it means th e binding is maintained across reboots. Parameters: WWPN - World Wi de Port Name of the HBA wh ose binding capabilities you wish[...]

The HBAnyware Utility User Man ual Page 1 12 GetDriverParamsGlobal Syntax: hbacmd GetDriverParamsGlobal <WWPN> Description: Shows the name and the glo bal value of each d river parameter for the HBA. Parameters: WWPN - World Wide Port Name of the HBA whose driver p arameter global names and values you wish to view SetDriverParam Syntax: hbacm[...]

The HBAnyware Utility User Man ual Page 1 13 SetAuthConfig Syntax: hbacmd SetAuthConfig <WWPN1> <WWPN2> <PasswordT ype > <Password> <Para meter> <V alue> Description: Sets the authentication configuration for the HBA. Parameters: WWPN1 - World Wide Port Name of the HBA whose authentication co nfiguratio n you wis[...]

The HBAnyware Utility User Man ual Page 1 14 InitiateAuth Syntax: hbacmd InitiateAuth <WWPN1> <WWPN2> Description: Initiates the authentication configuration o n the HBA. Parameters: WWPN1 - World Wide Port Name of the HBA whose authentication co nfiguratio n you wish to initiate WWPN2 - Must be ff:f f:ff:f f:ff:f f:f f:ff PCIDat a Synt[...]

The HBAnyware Utility User Man ual Page 1 15 PostT est Syntax: hbacmd PostT est <WWPN> Description: Runs the POST on the HBA. Support for a remote HBA is TCP/IP access on ly . Parameters: WWPN - World Wi de Port Name of the HBA on which you wish to run a POST EchoT est Syntax: hbacmd EchoT est <WWPN Source> <WWPN Destination> <[...]

The HBAnyware Utility User Man ual Page 1 16 GetRetentionCount Syntax: hbacmd GetRetentionCount <WWPN> Description: Displays the maximum number of diagno stic dump files store d for the HBA. Parameters: WWPN - World Wide Port Name of the HBA on which you wish to g et the retention count SetRetentionCount Syntax: hbacmd SetRetentionCount <W[...]

The HBAnyware Utility User Man ual Page 1 17 T roubleshooting There are several circumstances in which your system may operate in an un expected ma nner . The T roubleshooting section explains m any of these circu mstances and offers one or more workarounds for each situation. General Situations T able 1 1: General Situations Situation Resolution W[...]

The HBAnyware Utility User Man ual Page 1 18 SAN Management Workst ation Does Not Have a Fibre Channel Connection. The SAN management workst ation does not have a physical Fibre Channe l connection into the SAN because the other managemen t tools are all out-of-band. Can HBAnywa re be run on this SAN management workst ation? HBAnyware can communica[...]

The HBAnyware Utility User Man ual Page 1 19 Emulex Driver for W indow s and HBAnyware Situations Emulex Driver for Solaris LP FC an d HBAnyw are Situations T able 12: Emulex Driver for W indows and HBAnyware Situatio ns Situation Resolution lputilnt Installs, but HBAnyw are Does Not. When you run setup apps.exe, lputilnt inst alls but HBAnyware do[...]

The HBAnyware Utility User Manual Pag e 12 0 Emulex Driver for Linux and HBAnyware Situations T able 14: Emulex Driver for Linux and HBAny ware Situations Situation Resolution If a SAN configuration has 256 t argets mapped by the lpfc drive r , any additional added target s do not get a target ID mapping by the driver and cause target discovery to [...]

The HBAnyware Utility User Manual Pag e 12 1 Under cert ain conditions of an I/O load, some t argets cannot retire an I/O issued by a Linux initiator within the default timeout of 30 seconds given by the scsi midlayer . If the situation is not corrected, the initiator-to-target condi tion deteriorates into abort/recovery storms leading to I/O failu[...]

The HBAnyware Utility User Manual Pag e 12 2 "No module lpfc found for kerne l" error message. When upgrading the kernel, rpm generates the following error: "No modul e lpfc found fo r kernel KERNEL VERSION". A recently upgraded kernel cannot find the ramdisk. Afte r upgrading the kernel, the kernel cannot find the ramdisk which[...]

The HBAnyware Utility User Manual Pag e 12 3 The Linux SCSI subsystem only sees 8 LUNs when more are present. Some SCSI drivers will not scan past 8 LUNs when the t arget reports as a SCSI-2 device. Force SCSI bus scan with /usr/sbin/ lpfc/lun_scan. SuSE supplie s /bin/rescan-scsi -bus.sh which can be changed to scan everything. Cannot See Any HBAs[...]

The HBAnyware Utility User Manual Pag e 12 4 Cannot access formerly accessible servers via the Security Configurator or the HBAnyware Utility . This is actually a symptom of two different problems. • New Keys Were Ge nerated While Servers Were Of fline • Security Removed Wh ile Servers Were Offline T able 14: Emulex Driver for Linux and HBAny w[...]

The HBAnyware Utility User Manual Pag e 12 5 Security Configurator Situations - Acc ess Control Group s (ACG) Security Configuration Situatio ns - Access Sub-Group s (ASG) T able 15: Access Contro l Group s Situations Situation Resolution All servers are not displayed. When I run the Security Configurator on the Master Security Client (MSC), I do n[...]

The HBAnyware Utility User Manual Pag e 12 6 In the ASG tree of the Access Sub-G roups tab, one or more of the names of the ASG s is displayed as "- ASG (Client Offl ine) -". The client system for the ASG was not d iscovered when the Configur ator was star ted. This is actually a symptom of two different problems. • All Servers Are Not [...]

The HBAnyware Utility User Manual Pag e 12 7 HBAnyware Security Configurator Situations - Backup Masters T able 17: HBAnywa re Sec urity Confi gurator - Backu p Masters Situations Situation Resolution Cannot create a backup master . Select a system (or group of systems) from the MSC to be the Backup Master . The system must be either an unsecured s[...]

The HBAnyware Utility User Manual Pag e 12 8 Error Message Situations T able 18: Error Mess age Situations Situation Resolution The following error message is displayed when creating an ASG: “The Access Sub-Group name already exists. Plea se use a different name.” Y ou entered a du plicate ASG name in the Access Sub- Group Name field. At each l[...]

The HBAnyware Utility User Manual Pag e 12 9 Master Security Client Situations T able 19: Master Sec urity Client Situations Situation Resolution The MSC is no longer bootable or able to connect to the FC network. Y ou must reassign a Backup Master as the new MSC from the Backup Master . W arning: Use this procedure only if the MSC cannot relinquis[...]

The HBAnyware Utility User Manual Pag e 13 0 Non-Hierarchical and Hierarch ical ASG It is possible from a higher-level client (such as t he MSC) to creat e an ASG 1 with system A as the client and systems B, C, D, and E as servers. Then cr eate an ASG 2 with system E as the client, b ut with systems F and G as servers even though F an d G are not p[...]

The HBAnyware Utility User Manual Pag e 13 1 Figure 63: Hierar chical ASG Scenario[...]