Instruction/ maintenance manual of the product LP1150-F4 Emulex
Go to page of 175
Solaris SFS Driver User Manual Last Updated June 14, 2007.
Solaris SFS Driver User Manual Page ii Copyright© 200 7 Emulex Corp oration. All rights reserved wo rldwide. No part of this docu ment may be reproduced by any means nor translated to any electronic medium withou t the written consent of Em ulex Corporation.
Solaris SFS Driver User Manual Pag e iii Installation ................................. ..................................... ........................1 Introduction ......................................................................................
Solaris SFS Driver User Manual Pa ge iv Viewing HBA Information ....................................................................................... 41 Viewing Discovery Information ..................................................................
Solaris SFS Driver User Manual Pag e v Out-of-Band SAN Management ............................................................................. 77 Adding a Single Host ...................................................................................
Solaris SFS Driver User Manual Pa ge vi get_boot_rev ................................................................................................. 1 12 download_boot <filename> ................................................................
Solaris SFS Driver User Manual Pag e vii Console and Log Messages ................................................................................................ 139 Introduction .......................................................................
Solaris SFS Driver User Manual Pag e 1 Inst allation Introduction Comp atibility The S torEdge SAN Foundation Softwa re (SFS) driver and utilities suppo rt the following operating systems: • Solaris.
Solaris SFS Driver User Manual Pag e 2 Known Issues Minimum Driver for Fi rmware Instal lation on LPe1 1000 an d LPe1 1002 HBAs Y ou cannot install firmware version 2.7 0 or later on an LPe1 1000 or an LPe1 1002 HBA that is running a driver version earlier than 2.
Solaris SFS Driver User Manual Pag e 3 Inst alling the Solaris SFS Driver Downloading and Inst alling the Driver for Solaris 8 or 9 The Emulex FCA driver and the Solaris SFS prerequisites ca n be acquired in two ways. Meth od 1, Using the Install_it Script (the recommended method) or me thod 2, Using Individual Patches.
Solaris SFS Driver User Manual Pag e 4 b. Go to http://sunsolve.sun.com/pub-cgi/sh ow .p l?target=patchpage. Enter and download the fol- lowing required p atches: • 1 130 40 • 1 199 14 • 1 130 43 c. Follow the instructions to inst all eac h patch.
Solaris SFS Driver User Manual Pag e 5 Inst alling the FCA Utiliti es and the HBAnyware Utility Unp acking the Utility Files The FCA Utilities and the HBAnyware u tility are packaged together in one application kit tar file. T o unpack the tar file: 1.
Solaris SFS Driver User Manual Pag e 6 Prerequisites • Before installing the Emulex emlxu utilities package, you must completely install: • The Sun S torEdge SAN Foundation So ftware p ackage . • All the recommended patches as described in the Sun StorEdge SAN Foundation Software Installation Guide provided by Sun.
Solaris SFS Driver User Manual Pag e 7 Y ou do not need to reboot yo ur system to run a utility program, but you must either enter the progr am’s full path name, or add the package's bin directory (/opt/EMLXem lxu/bin) to your environment’s search path.
Solaris SFS Driver User Manual Pag e 8 6. When prompted by pkgadd, choose to install the HBAnyware utility . 7. When prompted by pkgadd , answer the HBAnyware installation questions.
Solaris SFS Driver User Manual Pag e 9 Inst alling the HBAnyware Ut ility Security Configurator Follow these instructions to install the Security Configurator on your system. Prerequisites • The HBAnyware utility must be installed on the system. • Java Runtime Enviro nment: V ersion 5 of the Java Runtime Environ ment (JRE) must be installed.
Solaris SFS Driver User Manual Pa ge 10 Procedure T o install the emlxu utilities package manually: 1. Log in as root, or su to root. 2. Copy the utilities kit from your distribution medium into a directory , referred to here as <directory>. The utilities kit is a .
Solaris SFS Driver User Manual Pag e 11 3. Remove the emlxu utilitie s package by typing: emlxu_remove 4. The script locates the EMLXemlxu utilities package, and the following messag e is displayed: <Removing EMLXemlxu package> 5.
Solaris SFS Driver User Manual Pa ge 12 Configuration Introduction The HBAnyware utility is launched directly from your Web browser . The utility is client/server based and allows you to perform confi.
Solaris SFS Driver User Manual Pa ge 13 Driver Parameters • The emlxs.conf file contains all the parameters necessary to initialize the Solaris SFS driver . In the emlx.conf file, all adapter-specific parameters have emlxs X -prefix (where X is the driver instance number); e.
Solaris SFS Driver User Manual Pa ge 14 Solaris SFS and lp fc Driver Pa rameter Cross-Reference T able T able 1: Solaris SFS and lpfc Driver Paramete r Cross-Reference Solaris SFS/ HBAnyware Parameter.
Solaris SFS Driver User Manual Pa ge 15 cr-delay Min:0 Max:63 Default:0 Description: S pecifies a count of milliseconds af ter which an interrupt response is generated if the cr-count has not been satisfied. This value is set to 0 to disable the Coalesce Resp onse feature as default.
Solaris SFS Driver User Manual Pa ge 16 network-on Min:0 (Disables) Max:1 (Enables) Default:1 Description: Enables or disables IP networking support in the drive r . network-on Min:0 (Disables) Max:1 (Enables) Default:1 Description: Controls whether lpfc provides IP networking functionality ove r FC.
Solaris SFS Driver User Manual Pa ge 17 pm-support 0 = Disables power management support in the driver . 1 = Enables power management support in the driver .
Solaris SFS Driver User Manual Pa ge 18 Using the HBAnyware Utility St arting the HBAnyware Util ity T o start the HBAnyware utility: 1. Login as or su to ‘root’.
Solaris SFS Driver User Manual Pa ge 19 St arting the HBAnyware Util ity from the Command Line T o launch the HBAnyw are ut ility from the command line: 1. T ype /usr/sbin/hbanyware/hbanywa re. This starts the HBAnyware utility running in in-band access.
Solaris SFS Driver User Manual Pa ge 20 The HBAnyware Utility Wind ow Element Definitions The HBAnyware utility window contains five basic components: the menu bar , the toolbar , the discovery- tree, the property tabs and the status bar .
Solaris SFS Driver User Manual Pa ge 21 The T oolbar Buttons The toolbar buttons perform the following tasks: Click the Rediscover butto n to refresh the discovery-tree display . Click the Reset button to reset the selected HBA. Sort T oolbar Buttons Y ou can sort discovered adapters by host name or fabric addresses.
Solaris SFS Driver User Manual Pa ge 22 Discovery-T ree Icons Discover- tree icons represen t the following: This icon represents the local host. This icon represents other hosts connected to the system. A green HBA icon with black descriptive text represents an online HBA.
Solaris SFS Driver User Manual Pa ge 23 Using the CLI Client The CLI Client is a console applica tion named hbacmd. Each time yo u run this application from the command line, a single ope ration is performed. The first parameter of this comma nd is the requested operation.
Solaris SFS Driver User Manual Pa ge 24 If you don’t know the IP address, but you know the host name, type: hbacmd h=cp-compaq8000 listHBAs If the host is unreachable, the comm and will return an error .
Solaris SFS Driver User Manual Pa ge 25 HBAAttrib Syntax: HBACMD HBAAttrib <wwpn> Description: Shows a list of all attributes for the HBA with the specified WWPN. T o view attributes, type: hbacmd hbaattrib 10:00:00:00:c9:20:0 8:cc Sample respon se: HBA Attributes for 10:00:00:00:c9:4a :c5:90 Host Name : localhost.
Solaris SFS Driver User Manual Pa ge 26 Fabric Name : 10 00 00 60 69 50 15 25 Parameters: WWPN - The World Wide Port Name of the por t. This port can be either local or remote. PortSt at Syntax: HBACMD PortS tat <wwpn> Description: Shows all port statistics for the HBA with the specified WWPN.
Solaris SFS Driver User Manual Pa ge 27 WWPN - The World Wi de Port Name of any HBA loca l to the designa ted server . The HBA itself can be either local or remote. Ta r g e t M a p p i n g Syntax: HBACMD T argetMapp ing <wwpn> Description: Shows a list of mapped targets and the LUNs attached to each for the port with the specified WWPN.
Solaris SFS Driver User Manual Pa ge 28 Parameters: WWPN - The World Wide Port Name of the por t. This port can be either local or remote. Download Syntax: HBACMD Download <wwpn> <filename> Description: Loads the specified firmware imag e to the HBA with the specified WWPN.
Solaris SFS Driver User Manual Pa ge 29 Parameters: WWPN - The World Wide Port Name of the HBA on which to set driver parameters. ctrlword - G = save the global parameter set. DriverParams Syntax: HBACMD DriverParams <wwpn> Description: Shows the name and values of each d river parameter for the selected HBA.
Solaris SFS Driver User Manual Pa ge 30 Parameters: WWPN - The World Wi de Port Name of the HBA whose driver parameters you want to view . This HBA can be either local or remote.
Solaris SFS Driver User Manual Pa ge 31 Sample respon se: Set Driver Parameter log_verbose=3(g ) for 10:00:00:00:c9:2e:51:2e Parameters: WWPN - The World Wide Port Name of the HBA whose Boot BIOS you want to modify . This HBA can be either local or remote.
Solaris SFS Driver User Manual Pa ge 32 W akeup Syntax: HBACMD wakeup <wwpn> Description: Shows wakeup parameter data for the HBA specified by the WWPN.
Solaris SFS Driver User Manual Pa ge 33 SetBeacon Syntax: HBACMD setbeacon <wwpn> <state> Description: Sets the current beacon status for the HBA specified by the WWPN.
Solaris SFS Driver User Manual Pa ge 34 Count - The number of tim es to run the test. S topOnError - Should the te st be halted on Error? 0 = no halt, 1 = ha lt Loopback Syntax: HBACMD loopback <wwpn> <type> <count> <S topOnError> Description: Runs the loop test on the HBA specified by the WWPN.
Solaris SFS Driver User Manual Pa ge 35 PersistentBi nding Syntax: HBACMD PersistentBinding <wwpn> <source> Description: Queries the pre sence of any persisten t bi nding that may exist for the specified WWPN. The <source> is used to query either the configured or live state of any binding that may be presen t.
Solaris SFS Driver User Manual Pa ge 36 ID - T arget WWPN if bindtype = P . T arget WWNN if bindtype = N. T arget D_ID if bindtype = D scsibus - Bus number of SCSI device.
Solaris SFS Driver User Manual Pa ge 37 BindingCap abilities Syntax: HBACMD BindingCapabilities <wwpn> Description: Displays the binding capabilities present at the referenced HBA.
Solaris SFS Driver User Manual Pa ge 38 Discovering HBAs Local and remote HBAs are discovered automatically when you launch the HBAn yware utility . Initially , both local and re mote HBAs are displayed. Y ou can also discover HBAs on out- of-band (OOB) hosts.
Solaris SFS Driver User Manual Pa ge 39 Configuring Discovery Settings Use the HBAnyware Discovery Settings dialog box to configure se veral discovery server parameters.
Solaris SFS Driver User Manual Pa ge 40 Sorting HBAs Sort discovered HBAs by host name, fabric name, HBA na me, target name and LUN number . Y ou can also choose to vi ew local HBAs or remo te HBAs. By def ault, both local an d remote HBAs are sorted by host name/fabric name.
Solaris SFS Driver User Manual Pa ge 41 V i ewing HBA Information Viewing Discovery Information The Discovery Information area co ntains a general summary of the discovered elemen ts. The Host or Fabric icon, depending upon which view you select, is the root of the discovery-tre e, but it does not represent a specific network element.
Solaris SFS Driver User Manual Pa ge 42 Viewing Host Information There are two tabs that show host information: the Host Inform ation tab and the host Driver Parameters tab. The Host Information tab is read-only . The h ost Driver Parameters tab enables you to view and define HBA driver settings for a specific host.
Solaris SFS Driver User Manual Pa ge 43 The Host Driver Parameters T ab The Host Driver Parameters tab (Figure 8) enables you to view and edit the HBA driver setting s contained in a specific host.
Solaris SFS Driver User Manual Pa ge 44 V iewing General HBA Attributes The General tab contains general attributes associated with the selected HBA. T o view general attribu tes: 1. S tart the HBAnyware utility . 2. Select Host or Fabric sort. 3. Click an HBA in the discovery-tree.
Solaris SFS Driver User Manual Pa ge 45 Adapter St atus Area Field Definitions S tate - The current operational state of the HBA: “Up” or “Down”.
Solaris SFS Driver User Manual Pa ge 46 Viewing Det ail ed HBA Information The Adapter Details tab in the HBAnyware utility contains detailed information associated with the selected HBA. T o view the d etailed attributes: 1. S tart the HBAnyware utility .
Solaris SFS Driver User Manual Pa ge 47 • Class-1 provides a dedicated connection between a pair of ports confirmed with delivery or notification of nondelivery . • Class-2 provides a fram e switched service with confirmed delivery or n otification of non- delivery .
Solaris SFS Driver User Manual Pa ge 48 Discovery Information Field Definitions • Number of Hosts - The number of hosts discovered or seen by this ho st on the selected fabric. • Number of Fabrics - The number fabrics identified dur ing discovery .
Solaris SFS Driver User Manual Pa ge 49 • Node WWN - A unique 64-bit num ber , in hexadecimal, for the target (N_PORT or NL_PORT). • Port WWN - A unique 64-bit number , in hexad ecimal, for the fabric (F_PORT or FL_PORT). • OS Device Name - The operating system device name.
Solaris SFS Driver User Manual Pa ge 50 • SCSI OS LUN - The SCSI identifier u sed by the operating system to map to the specific LUN. • OS Device Name - The name assigned by th e operating system to the selected LUN. • LUN Capacity • Capacity - The capacity of the LUN, in megabytes.
Solaris SFS Driver User Manual Pa ge 51 Port St atistics Field Definitions • Tx Frames - Fibre Channel frames tra nsmitted by this HBA port. • Tx Words - Fibre Channel words transmitted by this HBA port. • Tx KB Count - Fibre Channel kilob ytes transmitted by this HBA port.
Solaris SFS Driver User Manual Pa ge 52 V iewing Firmware Information Use the Firmware t ab to view current firmware versions, en able system BIOS and update firmware on remote and local HBAs. Th e update procedure is on page 55. T o view the firm ware information: 1.
Solaris SFS Driver User Manual Pa ge 53 • Up date Firmware - Click to this button to displa y the HBAnyware Firmware Download dialog box. Using the HBAnyware Firmware Do wnload dialog box, browse to the file yo u wish to download and download the file.
Solaris SFS Driver User Manual Pa ge 54 Display Mode Radio Buttons •S h o w W W P N • Show WWNN • Show D_ID T arget Mapping Buttons • Change Sett ings - Click to change the Bind T ype, the mode used to persistently bind target mappings. The Mapped T arget Settings window is displayed.
Solaris SFS Driver User Manual Pa ge 55 4. The following warning screen ap pears: Figure 17: HBAnyware Utilit y , Reset Warning Screen 5. Click Ye s . The HBA reset s. The reset may require several seconds to com plete. While the HBA is resetting, the status bar shows “Reset in progress.
Solaris SFS Driver User Manual Pa ge 56 3. Select the Firmware tab. Figure 18: HBAnyware Utility , Firmware T ab 4. Click Up date Firmware . The Firmware Download dialog box appears.
Solaris SFS Driver User Manual Pa ge 57 5. Click Browse . The Firmware File Selection dialog box appears. Figure 20: HBAnyware Utility , Firm ware File Selection Dialog Box 6. Navigate to the extracted firm ware file you wish to download. Select the file and click OK .
Solaris SFS Driver User Manual Pa ge 58 Up dating Firmware (Batch Mode) Loading firmware in batch mode dif fers from its non-batch counte rpart in that it enables you to install firmware on multiple HBAs in a single step. Batch firmware loading is restri cted to a single firmware file and to all accessible HBAs for whic h that file is compatible.
Solaris SFS Driver User Manual Pa ge 59 6. When selection/deselection is complete, click St art Download . 7. Once downloading begins, the tree- view displays the progress. As firmware for a selected HBA is being downloaded, it appears orange in the tr ee-view .
Solaris SFS Driver User Manual Pa ge 60 3. Select the Firm ware tab. Figure 23: HBAnyware Ut ility , Firmware T ab with BIOS Disabled 4. T o enable or disable the BIOS, click Enable .
Solaris SFS Driver User Manual Pa ge 61 Setting Driver Parame ters for an HBA T o change the driver parameters for an HBA: 1. S tart the HBAnyware utility . 2. Do one of the following: • From the menu bar , click Vi e w , then click Sort by Host Name .
Solaris SFS Driver User Manual Pa ge 62 Restoring All Para meters to Their Earlier V alues If you changed parameters, but did not click Apply and you wa nt to restore the parameters to their last saved values, click Restore . Resetting All Default V alues If you want to reset all parameter values to their default (factory) values, click Default s .
Solaris SFS Driver User Manual Pa ge 63 7. If you want the change to be tempora ry (causing the parameter to revert to its last permanent setting when the system is rebooted), check th e "Make change temporary" box. This o ption is availabl e only for dynamic pa rameters.
Solaris SFS Driver User Manual Pa ge 64 Creating the Batch Mode Driver Parameters File Y ou can apply driver parameters for one HBA to other HBAs in the syste m using the Driver Parameters tab. When you define parameters for an HBA, you create a .dpv file.
Solaris SFS Driver User Manual Pa ge 65 3. Select the file whose parameters you wish to apply an d click Open . The Batch Driver Parameter Update dialog box shows all the batch file com patible HBAs with a check mark beside them. Figure 27: HBAnyware Utility , Batch Dr iver Parameters Up date Dialog Box 4.
Solaris SFS Driver User Manual Pa ge 66 3. Click the T arget Mapping tab. All ta rgets are displayed. Figure 28: HBAnyware Utilit y , T arget Mapping T ab 4. The information for each currently define d mapping includes the world wide port name (WWPN), world wide node name (WWNN), device ID (D_ ID), SCSI ID, or Bind T ype.
Solaris SFS Driver User Manual Pa ge 67 T o ad d 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 29: HBAnyware Utility , Add Persistent Binding Dialog Box 3.
Solaris SFS Driver User Manual Pa ge 68 T o bind a target that does not appear in the Persistent Binding T able: 1. Click Bind New T arget . The Bind New T arget dialog box is d isplayed.
Solaris SFS Driver User Manual Pa ge 69 Setting Up T arget/LUN Blocking Using sd.conf The class keyword ("scsi") ensures that Solaris specificall y probes all adapters controlled by all driver that register themselves as class="scsi".
Solaris SFS Driver User Manual Pa ge 70 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 (s.
Solaris SFS Driver User Manual Pa ge 71 3. Select the Diagnostics tab and click Quick T est . The following message appears: Figure 32: HBAnyware Ut ility , Quick T est Message 4. Click OK to run the test. The Quick Diagnostics T e st message shows the PCI Loopback and Internal Loopback test results.
Solaris SFS Driver User Manual Pa ge 72 Creating Diagnostic Dump s The diagnostic dump featu re enables you to create a “dump” file fo r a selected HBA. Dump files contain various information such as firmware version , driver version and so on, that is particularly useful when troubleshooting an HBA.
Solaris SFS Driver User Manual Pa ge 73 Running Advanced Diagnostic T ests The Advanced Diagnostics fea ture gives you greater control than the Quick T est over the typ e 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.
Solaris SFS Driver User Manual Pa ge 74 Running Loopback T ests T o run a loopback test, use the "Loopback T est" se ction of the Ad vanced Diagnostics dialog box.
Solaris SFS Driver User Manual Pa ge 75 5. Click OK . If you choose to run an External Loopba ck test the following window appears: Figure 38: HBAnyware Utility , Advanced Diagnostic T ests Wa rning for External Loopback 6. Click OK . The progress bar indicates that the test is runn ing.
Solaris SFS Driver User Manual Pa ge 76 All relevant information for th e selected port is automatically added to the T arget Identifier sec- tion of the Diagnostics dialog box. Figure 39: HBAnyware Utility , Se lect Echo T est T arget Window 5. Click Start .
Solaris SFS Driver User Manual Pa ge 77 An example of a saved log file appears b elow: Figure 41: DiagT estLog Window T o save the log file: 1. After running a test from the Diagnostic T est Setup dialog box, Click Save to File . The Select Diagnostic Log file Name dialog box app ears.
Solaris SFS Driver User Manual Pa ge 78 Adding a Single Host The HBAnyware utility enables you to spe cify a single OOB host to manage. If the host is successfully discovered as a manageable host, it is added to the static list of hosts and if it has not been discovered in-band, the host and its HBAs are added to the discovery tree.
Solaris SFS Driver User Manual Pa ge 79 Adding a Range of Host s Y ou can find th e OOB manageable hosts by search ing a range o f IP addresses using the Ad d Range of IP Hosts dialog box. Figure 43: HBAnyware Utility , Add Remote Hosts Window The Add Range of IP Hosts dialog box enables you to build the initia l list of OOB manageable hosts.
Solaris SFS Driver User Manual Pa ge 80 6. A dialog box appears asking to save the IP ranges you search ed. Click Ye s to save the address ranges. If you save the addre ss ranges, these address ranges will appear the next time yo u use the Add Range of IP Hosts dialog box.
Solaris SFS Driver User Manual Pa ge 81 • SA_ID - An index (into the SA table) that is passed in the CT command descriptor to indicate which Access Control Record (containing the key is being used to encrypt/decrypt the command data) to use in the SA table.
Solaris SFS Driver User Manual Pa ge 82 St arting the Security Configurator fo r the First T ime: Creating the First ACG , Designating the MSC and Sele cting Systems in the FC Network Prerequisites • The Solaris SFS Driver is installed. • The HBAnyware and lputil utilities are installed.
Solaris SFS Driver User Manual Pa ge 83 All of the available servers are discovered a nd available to become part of the system Access Control Group (ACG ). 3. Select the unsecured servers to be added to the ACG from the Available Servers list. Figure 47: Security Conf igurator , Access Group Co ntrol T ab with Call Outs 4.
Solaris SFS Driver User Manual Pa ge 84 a. The SSC utility runs . b. SA_ID is selected. c. SA files are created fo r systems 2 through 5. d. SA files ar e sent to ea ch system an d system 1 becomes an AC G and an M SC, the only sys- tem which can run the HBAnyware client to remotely access all othe r system.
Solaris SFS Driver User Manual Pa ge 85 When you select systems in the AC G and move them to the Available Servers l ist, the security configuration for those systems is update d to make them unsecure.
Solaris SFS Driver User Manual Pa ge 86 The system is a secure server in the ACG . It does not belong to an Access Sub-Group (ASG). Y ou can remove this system from the ACG . The system is a secure server in the ACG and belongs to one or more ASGs. Y ou can remove this system from the ACG .
Solaris SFS Driver User Manual Pa ge 87 Deleting a Server from the ACG T o de lete a server from the Access Contr ol Group (ACG): 1. S tart the HBAnyware Security Configurator . 2. On the Access Control Group tab, from the Access Control Group Servers list, select the secured systems that you want to delete fro m the ACG .
Solaris SFS Driver User Manual Pa ge 88 Removing Security from all Servers in the ACG Y ou can remove security from al l systems only from the Master Security Client (MSC). Removing the entire security topology on all of the servers in the MSC's ACG puts the servers in an unsecure state.
Solaris SFS Driver User Manual Pa ge 89 Generating New Security Keys Y ou can generate new security keys only from a Master Security Client (MSC). After the new security keys are generated, they are automatically sent to all of the remote servers in the Access Control Group (ACG).
Solaris SFS Driver User Manual Pa ge 90 Restoring the ACG to It s Last Saved Configuration Y ou can restore the ACG to its last saved configuration, if there are unsaved chan ges to the ACG , only from the Master Security Client (MSC). T o restore the ACG to its last saved configuration: 1.
Solaris SFS Driver User Manual Pa ge 91 Accessing a Switch Y ou can enable switch access only on a Master Security Client (MSC). Switch access grants the client access rights to a switch to remotely access HBAs on servers in the Access Control Group (ACG).
Solaris SFS Driver User Manual Pa ge 92 Access Sub-Group s Introduction The Access Sub-Group tab allows you to create multiple Access Sub-Gr oups (ASGs) and multiple levels (tiers) in the security topology hierarchy . The hierarchy can be as many levels deep a s desired.
Solaris SFS Driver User Manual Pa ge 93 Creating an ASG Y ou create a new Access Sub-Grou p (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 .
Solaris SFS Driver User Manual Pa ge 94 5. Click OK in the New Access Sub-Group dialog box. The ASG is created. T he following process sets up the ASG (see Figure 61) a. The SSC utility runs . b. A new ASG is created with Systems 2 and 15 as clients. c.
Solaris SFS Driver User Manual Pa ge 95 Adding a Server to an ASG T o ad d a server to an ASG: 1. S tart the HBAnyware Security Configurator . 2. Click the Access Sub-Group t ab. Figure 62: Security Conf igurator , Access Sub-Gr oups T ab with Available Servers 3.
Solaris SFS Driver User Manual Pa ge 96 Restoring an ASG to Its Last Saved Configuration Y ou can restore an ASG to its last saved configuration if there are unsaved changes to it. T o resto re an ASG to its last saved configuration: 1. Click the Access Sub-Group t ab.
Solaris SFS Driver User Manual Pa ge 97 Editing an ASG Y ou can change the name, client system or reserved indices of an Access Sub-Grou p (ASG). T o ed it an ASG: 1. S tart the HBAnyware Security Configurator . 2. Click the Access Sub-Group t ab. Figure 64: Security Conf igurator , Access Sub-Gr oups T ab with Available Servers 3.
Solaris SFS Driver User Manual Pa ge 98 system. See the Reserved Indices topic (un der Access Sub-Groups in this manual) for examples. 6. Click OK in the Edit Access Sub-Group dialog box to save your changes. About Offline ASGs Sometimes a client system may not be online when the HBAnyware Security Configu rator is running.
Solaris SFS Driver User Manual Pa ge 99 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 becomes unable to operate or is removed from the secu rity configuration.
Solaris SFS Driver User Manual Pa ge 1 00 Backup Master T ab and Controls The first time the Backup Ma ster tab is selected on the MSC, it looks similar to the following: Figure 68: Security Conf igurator , Backu p Master T ab (in itial view) Creating a Backup Master T o create a Backup Master: 1.
Solaris SFS Driver User Manual Pa ge 1 01 a. The SSC utility runs . b. Discovery finds S ystem 16. c. The SA File is sent to System 16 with the correct SA_ID set for s erver access.
Solaris SFS Driver User Manual Pa ge 1 02 2. Click the Backup Master t ab. Figure 71: Security Conf igurator , Backu p Master T ab with Ba ckup Master Selected 3. In the Backup Masters list, select the Backup Ma ster system that you want to reassign as the MSC.
Solaris SFS Driver User Manual Pa ge 1 03 Reassigning a Backup Master as th e New MSC from the Backup Master T o reassign a Backup Master as th e new MSC from the Backup M a ster: 1. On the Backup Master system that you want to reassign as the MSC, start the HBAnyware Security Configurator .
Solaris SFS Driver User Manual Pa ge 1 04 Using the emlxadm Utility The emlxadm utility is a direct user interface to the FCIO interface provided by the Sun S torEdge Solaris SFS. The FCIO interface provides a Sun common ioctl interface to the FCTL, which m anages the FCA drivers for each FC HBA attached to the host system.
Solaris SFS Driver User Manual Pa ge 1 05 reset_link <wwpn,0> - Resets the lin k of a specified FC device. reset_hard - Reset the HBA. reset_hard_core - Reset the HBA firm ware core. diag <test> - Perform a diagnostic t est on the HBA. ns - Performs a complete query of th e fabric name server.
Solaris SFS Driver User Manual Pa ge 1 06 # If you do not want the utility to paus e for verification, add a "-y" option just after the device path, and the emlxadm utility will skip the verification.
Solaris SFS Driver User Manual Pa ge 1 07 Command Descriptions ( emlxadm) This section provides a list of comman ds and descriptions that can be issued with the emlxad m utility . get_num_devs Returns the number of FC devices currently se en by this HBA port.
Solaris SFS Driver User Manual Pa ge 1 08 get_logi_p arams <wwpn> Returns the FC login common se rvice parameters for a specified FC device on the netwo rk.
Solaris SFS Driver User Manual Pa ge 1 09 get_sym_pname Returns the symbolic FC port name of the HBA port. Example: emlxadm> get_sym_pname ioctl: FCIO_GET_SYM_PNAME: Operation not supported set_sym_pname <"string"> Sets the symbolic FC port name of the HBA to the string provided.
Solaris SFS Driver User Manual Pag e 110 dev_logout <wwpn> Performs an FC logout to an FC device on the network, if n ot already logged in. Example: emlxadm> dev_logout 21000020371938fa Done. get_st ate <wwpn> Returns the current Leadville state of the specified FC device o n the network.
Solaris SFS Driver User Manual Pag e 11 1 download_fcode <filename> Downloads the specified FCode im age file to the HBA. Example: emlxadm> download_fcode LP10000DC-S. fcode Image Components: REL type size=33 848 DWC file: BOOT: version=03 841512, 1.
Solaris SFS Driver User Manual Pag e 112 get_boot_rev Returns the current boot revision of the HBA. Example: emlxadm> get_boot_rev Firmware revision: LP10000DC-S 1.90a 3 download_boot <filename> Downloads the specified boot image file to the HBA.
Solaris SFS Driver User Manual Pag e 113 The following is a n example of the text file created by this operation. The binary version of the file has the binary pattern indicated without the column or row labels an d white spaces.
Solaris SFS Driver User Manual Pag e 114 reset_hard_core Forces the HBA to perform a core firmware re set. Example: emlxadm> reset_hard_core Done. diag <test [p arameters]> or diag code <cmd_code (hex)> Performs the specified diagnostics function or command code on the HBA port.
Solaris SFS Driver User Manual Pag e 115 ns Performs and returns a comple te query of the fabric name server . Example: emlxadm> ns Nameserver: ------------------------------------ ----------------.
Solaris SFS Driver User Manual Pag e 116 p arm_get_list Returns a list of configurable parameters. Example: emlxadm> parm_get_list Parameter: ------------------------------------ ------------------.
Solaris SFS Driver User Manual Pag e 117 ------------------------------------ ----------------------------- label: ub-bufs min: 40 current: 1000 max: 16320 default: 1000 dynamic: no desc: Number of unsolicited buffe rs the driver should allocate.
Solaris SFS Driver User Manual Pag e 118 ------------------------------------ ----------------------------- label: assign-alpa min: 0x0 current: 0x0 max: 0xef default: 0x0 dynamic: no desc: Assigns a preferred ALPA to the port. Only used in Loop topology.
Solaris SFS Driver User Manual Pag e 119 msgbuf all or <numbe r> [-i interval] Displays all or part (the last <number> of lines) of the current driver message log, and can up date the screen every <interval> seconds if desire d. T o stop the pro gram from updating the screen, p ress <Ctrl> + <C> .
Solaris SFS Driver User Manual Pa ge 1 20 00000000, 00000000, 00000000 , 00000000, Port Symbolic Name = non e Port Supported Speed = 1Gb , 2Gb Port Speed = 1Gb Port Max Frame Size = 0x8 00 bytes Fabri.
Solaris SFS Driver User Manual Pa ge 1 21 Port State = Unk nown Port Supported COS = Cla ss3 Port Supported FC4 Types: 00000000, 00000000, 00000000 , 00000000, 00000000, 00000000, 00000000 , 00000000,.
Solaris SFS Driver User Manual Pa ge 1 22 get_vp d Displays the current ad apter's vital product data (VPD). Example: emlxadm> get_vpd Vital Product Data: Identifier (ID): FC2G PCI-X LP1 0000DC - SUN Part Number (PN): LP10000DC-S Manufacturer (MN): Sun Microsyste ms, Inc.
Solaris SFS Driver User Manual Pa ge 1 23 dev_remove <wwpn> - Remove the FC d evice from Leadville management. link_status <d_id> - Request link e rror status from a specified D_ID. get_fcode_rev - Returns the current Fcode revison of the HBA.
Solaris SFS Driver User Manual Pa ge 1 24 Using the emlxdrv Utility The emlxdrv utility is use d for binding (associa ting) the Emulex emlxs (Leadville F C) driver and the Emulex lpfc (traditional non-Leadville FC) driver to the various models of Emulex F C HBAs.
Solaris SFS Driver User Manual Pa ge 1 25 The display comprises three part s: the current driver configuration table, a list of available commands and the emlxdrv prompt. The driver configuration table contains the following columns of data: • Driver .
Solaris SFS Driver User Manual Pa ge 1 26 emlxs f0a5 no no no 2G Bl ade Adapter (emlxs only) emlxs fc00 yes no yes LP100 00-S and LP10000DC-S emlxs fc10 no no yes LP110 00-S and LP11002-S (emlxs only).
Solaris SFS Driver User Manual Pa ge 1 27 Cannot unload module: lpfc Will be unloaded upon reboot. Updating f980 ... Cannot unload module: lpfc Will be unloaded upon reboot. Updating fa00 ... Updating fd00 ... Updating fe00 ... Updating fc00 ... Updating fc10 .
Solaris SFS Driver User Manual Pa ge 1 28 Y ou may see the m essage "Cannot unload module". This indicates that you must reboot the system to get a driver to unbind from that adapte r alias; emlxdrv only update s the system configuration for the next boot.
Solaris SFS Driver User Manual Pa ge 1 29 clear_sun Clears driver bindings to all Sun devices. Y ou may see the message "Cannot unload module". This indicates that you must reboot the system to get a drive r to unbind from that adapter alias; emlxdrv only updates the system configuration for the next boot.
Solaris SFS Driver User Manual Pa ge 1 30 clear_all Clears driver bindings to all devices. Y ou may se e the me ssage "Cannot unload module". This indicates that you must reboot the system to get a driver to unbind from that adapter a lias; emlxdrv only updates the system configuration for the next boot.
Solaris SFS Driver User Manual Pa ge 1 31 T roubleshooting Introduction This T r oubleshooting section contains the following ta bles with helpful information should yo ur system operate in an unexpected man ner . These tables explai n many of these circumstances and offers one or more workarounds for each situ ation.
Solaris SFS Driver User Manual Pa ge 1 32 Cannot See Other HBAs or Host s. Although the HBAnyware utility is inst alled, only local HBAs are vi sible. The other HBAs and hosts in the SAN cannot be seen.
Solaris SFS Driver User Manual Pa ge 1 33 Security Configurator Situati ons - Access Control Groups (ACG) Cannot run the Security Configurator on a system that is configured for only secure access. I cannot run the Security Configurator on a system that is configured for only secure server access (it has no client privileges).
Solaris SFS Driver User Manual Pa ge 1 34 Security Configurat ion Situations - Access Sub-Groups (ASG) T able 3: HBAnyware Security Configurator - Acc ess Sub-Group s Situations Situation Resolution ASG Appears to Be Non-Hierarchical.
Solaris SFS Driver User Manual Pa ge 1 35 HBAnyware Security Configurator Situations - Backup Maste rs Not All Servers are available to an ASG . When you create a new ASG or modify a n existing ASG , not all of the servers in the ACG are available to be added to the ASG .
Solaris SFS Driver User Manual Pa ge 1 36 Error Message Situations The Backup Master t ab is not available. The Backup Master t ab is displayed only when the Security Configurator is running on the MSC or a Backup Master . Y ou use this tab to set up a system or systems to be backups to the MSC and to replace the MSC w ith a Backup Master .
Solaris SFS Driver User Manual Pa ge 1 37 Master Security Client Situa tions The first time th e Security Configurator is started in an unsecure environment, the following message is displayed: “This utility i s running on an unsecure system.
Solaris SFS Driver User Manual Pa ge 1 38 Security Removed While Servers We re Offline. Security was removed while one o r more servers were offli ne. I can no longer access those servers from the Security Configurator or the HBAnyware utility . The servers are no longer p art of the security configuration.
Solaris SFS Driver User Manual Pa ge 1 39 Console and Log Messages Introduction Log messages are logge d to the /var/adm/messa ges system file. T able 7: Notice, W arnings and Error T ypes T able 8 list s the types of log messages tha t can be logged to the system file .
Solaris SFS Driver User Manual Pa ge 1 40 Severity Levels Message Log Example The following is an example of a message on the system console. [5.0336]emlxs0: NOTICE: 720: Link up . (1Gb, fabric) The following is an exam ple of the same message in the syste m message log (/var/adm/m essages) file.
Solaris SFS Driver User Manual Pa ge 1 41 • Jan 19 14:45:36 unid entified the date and time when the error or event occurred. • sunv240 identifie s the name of the host machin e. • emlxs identifies the message came from the Emulex emlxs d river .
Solaris SFS Driver User Manual Pa ge 1 42 MSG_ID: 0005 Panic VERBOSE_MASK: LOG_MI SC (0x00000001) DESCRIPTION: This is a general purpos e panic message.
Solaris SFS Driver User Manual Pa ge 1 43 MSG_ID: 01 12 Debug : Driver Det ach VERBOSE_MASK: LOG_DRIVER (0x00000002) DESCRIPTION: This indicates tha t the driver is performing an detach o peration. SEVERITY LEVEL: Debug MESSAGE: Driver detach ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 44 MSG_ID: 0201 Error: Adapter Initialization Failed VERBOSE_MASK: LOG_INIT (0x00000004) DESCRIPTION: This indicates that an a ttempt to initialize t he adapter has failed. SEVERITY LEVEL: Error MESSAGE: Adapter init ialization failed ACTION: Check your hardware co nfiguration.
Solaris SFS Driver User Manual Pa ge 1 45 Memory Manage ment Events MSG_ID: 0300 Debug: Memo ry Allocated VERBOSE_MASK: LOG_MEM (0x00000008) DESCRIPTION: This indicates that th e driver allocated system memory. SEVERITY LEVEL: Debug MESSAGE: Memory alloc ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 46 Service Level Inte rface (SLI) Event s MSG_ID: 0400 Debug: V ital Product Data VERBOSE_MASK: LOG_ SLI (0x00000010) DESCRIPTION: This provides vendor-specific information abo ut the adapter. SEVERITY LEVEL: Debug MESSAGE: Vital Product Data ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 47 MSG_ID: 0432 Debug: Ring Reset VERBOSE_MASK: LOG_ SLI (0x00000010) DESCRIPTION: This indicates an SLI ring is being reset.
Solaris SFS Driver User Manual Pa ge 1 48 Mailbox Event s MSG_ID: 0500 Debug: Mailb ox Event VERBOSE_MASK: LOG_MBOX (0x00000020) DESCRIPTION: This indicates that a mailbox ev ent has occurre d. SEVERITY LEVEL: Debug MESSAGE: Mailbox event ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 49 MSG_ID: 0602 Notice: Nod e Create Failed VERBOSE_MASK: LOG_NO DE (0x00000040) DESCRIPTION: This indicates that a node create request for a remote device has fa iled. SEVERITY LEVEL: Notice MESSAGE: Node create failed ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 50 Link Event s MSG_ID: 0700 Debug: Lin k Event VERBOSE_MASK: LOG_SLI (0x00000010) or LOG_LINK (0x00000080) DESCRIPTION: This indicates th at a link even t has occurred. SEVERITY LEVEL: Debug MESSAGE: Link event ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 51 ELS Events MSG_ID: 0800 Debug: ELS Sent VERBOSE_MASK: LOG_ ELS (0x00000100) DESCRIPTION: This indicates that an ELS command is being sent. SEVERITY LEVEL: Debug MESSAGE: ELS sent ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 52 MSG_ID: 0822 Debug: ELS Reply VERBOSE_MASK: LOG_ ELS (0x00000100) DESCRIPTION: This indicates that a reply is being sent for an unsolicited ELS command. SEVERITY LEVEL: Debug MESSAGE: ELS reply ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 53 MSG_ID: 091 1 Debug: TXQ W atchdog VERBOSE_MASK: LOG_ PKT (0x00000200) DESCRIPTION: This indicate s that I/O(s) was found missing from the transmit queue. SEVERITY LEVEL: Debug MESSAGE: TXQ watchdog ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 54 MSG_ID: 0932 Debug: Pac ket T ransport VERBOSE_MASK: LOG_ PKT (0x00000200) DESCRIPTION: This provides additional informatio n about a packet being sent. SEVERITY LEVEL: Debug MESSAGE: Packet transport ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 55 MSG_ID: 121 1 Debug: Abnormal IP Completion VERBOSE_MASK: LOG_IP (0x00001000) DESCRIPTION: This indicates that an IP sequence co mpleted with a status error in the IOCB. It could mean the FC device on the networ k is not responding.
Solaris SFS Driver User Manual Pa ge 1 56 MSG_ID: 1310 W arning: Diagnostic Error VERBOSE_MASK: LOG_ SFS (0x00002000) DESCRIPTION: This indicates that a diagnostic r equest did not complete because of so me issue. SEVERITY LEVEL: Warning MESSAGE: Diagnostic error ACTION: No action needed.
Solaris SFS Driver User Manual Pa ge 1 57 MSG_ID: 1316 Error: POST Diagno stic Failed VERBOSE_MASK: LOG_ SFS (0x00002000) DESCRIPTION: This indicates that a POST diagnostic has failed to return a positive result. This is usually caused by an adapte r hardware pro blem.
Solaris SFS Driver User Manual Pa ge 1 58 Firmware Download Event s MSG_ID: 1500 Debug: Firm ware Image VERBOSE_MASK: LOG_FI RMWARE (0x00008000) DESCRIPTION: This provid es information about t he firmware interface. SEVERITY LEVEL: Debug MESSAGE: Firmware image ACTION: No action needed, informational.
Solaris SFS Driver User Manual Pa ge 1 59 MSG_ID: 1522 Error: Firmware Do wnload Failed VERBOSE_MASK: LOG_FI RMWARE (0x00008000) DESCRIPTION: This indicates that an atte mpt to download a firmware image was failed. SEVERITY LEVEL: Error MESSAGE: Firmware download failed ACTION: Check your hardware co nfiguration.
Solaris SFS Driver User Manual Pa ge 1 60 MSG_ID: 1621 Debug: Uns o licited CT dropp ed VERBOSE_MASK: LOG_ CT(0x00010000) DESCRIPTION: This indicates that an unsolicited CT command was received and the n dropped for some reason. SEVERITY LEVEL: Debug MESSAGE: Unsolicited CT dropped.
Solaris SFS Driver User Manual Pa ge 1 61 Appendix Introduction Use Cases Note: The concurrent production use of em lxs (Leadville) and lp fc on a given serv er is not supported. Transient co- existence is required in some mi gration use cases but must be discontinued before going into production.
Solaris SFS Driver User Manual Pa ge 1 62 Migrating from the Solaris lp fc Driver to the Solaris SFS Driver If the Emulex lpfc driver for Solaris is already installed, you can migrate to the Solar is SFS driver either by customizing and running the unsupported sample scripts provided by Em ulex, or by manually performing a set of procedu res.
Solaris SFS Driver User Manual Pa ge 1 63 5. V erifies that the system boot device is not an Emulex HBA (if so , the sample script exits with an explanation). 6. Obtains and verifies the FCode version for each HBA in the system. If the FCode version is not compatible, the sample script errors, then exit s.
Solaris SFS Driver User Manual Pa ge 1 64 Migrating a Configur ation without FC Boot Migrating Automatically Automatic migration provides an equ ivalent FC storage setup running on the Solaris FC (L eadville) stack. Emulex's Solaris lpfc driver on the SP ARC platform uses "sd" as the native SCSI driver , and works in Solaris 2.
Solaris SFS Driver User Manual Pa ge 1 65 Migrating Manually T o migr ate manually: 1. Back up all data and system di sks. 2. Note current lpfc target and LUN information contained in the following files: • /etc/vfstab • /kernel/drv/lp fc.conf • /kernel/drv/sd.
Solaris SFS Driver User Manual Pa ge 1 66 1 1. Configure an y targets that were used with the lpfc driver ( cfgadm - a to display the target list, cfgadm -c conf igure <ApId> to configure the ApId's storage). The ApId can also be referenced in the /kernel/drv/l pfc.
Solaris SFS Driver User Manual Pa ge 1 67 /pci@8,60000 0/lpfc@2 . . . {0} ok " /pci@8,6000 00/lpfc@2" select-dev {0} ok set-sfs-bo ot {0} ok reset-all e. Boot the system to the OS. 6. Define or designate a n alternate boot drive for DAS boot through SF S and the Sun or Emulex HBA.
Solaris SFS Driver User Manual Pa ge 1 68 Migrating an lp fc Conf iguration to emlxs – A dding Sun-Branded HBAs This case applies if you plan to migrate all or some of your existing HBAs from lpfc to emlxs, as well as adding Sun-branded HBAs.
An important point after buying a device Emulex LP1150-F4 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Emulex LP1150-F4 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Emulex LP1150-F4 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Emulex LP1150-F4 you will learn all the available features of the product, as well as information on its operation. The information that you get Emulex LP1150-F4 will certainly help you make a decision on the purchase.
If you already are a holder of Emulex LP1150-F4, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Emulex LP1150-F4.
However, one of the most important roles played by the user manual is to help in solving problems with Emulex LP1150-F4. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Emulex LP1150-F4 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
