Emulex LP1005DC-CM2 Manual do Utilizador

Emulex Driver and Utilities for LinuxVersion 7.3User Manual

Driver for Linux - Installation Section Page 4Once the 'lpfc-install' script has completed successfully, the Emulex lpfc and lpfcdfc drivers

Driver for Linux -Troubleshooting Section Page 94"attached usage count = -1" Error Message. Some distributions of SuSE Linux Enterprise Ser

Driver for Linux -Troubleshooting Section Page 95Cannot See Other HBAs or Hosts. Although HBAnyware is installed, only local host bus adapters (HBAs)

Driver for Linux -Troubleshooting Section Page 96Security Configurator Situations - Access Control Groups (ACGs)The HBAnyware Security Configurator (S

Driver for Linux -Troubleshooting Section Page 97Security Configuration Situations - Access Sub-Groups (ASG) Table 5: HBAnyware Security Configurator

Driver for Linux -Troubleshooting Section Page 98HBAnyware Security Configurator Situations - Backup MastersTable 6: HBAnyware Security Configurator -

Driver for Linux -Troubleshooting Section Page 99Error Message SituationsTable 7: Error Message SituationsSituation ResolutionThe following error mess

Driver for Linux -Troubleshooting Section Page 100Master Security Client SituationsTable 8: Master Security Client SituationsSituation ResolutionThe M

Driver for Linux -Troubleshooting Section Page 101Non-Hierarchical and Hierarchical ASGIt is possible from a higher-level client (such as the MSC) to

Driver for Linux -Troubleshooting Section Page 102Figure 61: Hierarchical ASG Scenario lpfc Log MessagesIntroductonLog messages are organized into log

Driver for Linux -Troubleshooting Section Page 103Message Group Masks Table 10 defines the log message groups and the associated number ranges. • The

Driver for Linux - Installation Section Page 5Installing the Driver on Unsupported Linux DistributionsThe driver kit supports the Linux distributions

Driver for Linux -Troubleshooting Section Page 104Message Log ExampleThe following is an example of a LOG message:Jul 12 16:30:26 <node> kernel:

Driver for Linux -Troubleshooting Section Page 105ELS Events (0100 - 0199)elx_mes0100: FLOGI failureDESCRIPTION: An ELS FLOGI command that was sent to

Driver for Linux -Troubleshooting Section Page 106elx_mes0106: ELS cmd tag <ulpIoTag> completesDESCRIPTION: The specific ELS command was complet

Driver for Linux -Troubleshooting Section Page 107elx_mes0112: ELS command <elsCmd> received from NPORT <did> DESCRIPTION: Received the sp

Driver for Linux -Troubleshooting Section Page 108elx_mes0118: Xmit CT response on exchange <xid>DESCRIPTION: Xmit a CT response on the appropri

Driver for Linux -Troubleshooting Section Page 109elx_mes0124:PLOGI chkparm OKDESCRIPTION: Received a PLOGI from a remote NPORT and its Fibre Channel

Driver for Linux -Troubleshooting Section Page 110elx_mes0202: Start Discovery hba state <hba_state>DESCRIPTION: Device discovery / rediscovery

Driver for Linux -Troubleshooting Section Page 111elx_mes0208: Failmask change on NPort <nlp_DID>DESCRIPTION: An event was processed that indica

Driver for Linux -Troubleshooting Section Page 112elx_mes0215: RSCN receivedDESCRIPTION: An RSCN ELS command was received from a fabric and processed.

Driver for Linux -Troubleshooting Section Page 113elx_mes0221: FAN timeoutDESCRIPTION: A link up event was received without the login bit set, so the

Driver for Linux - Installation Section Page 6Upgrading the KernelThere are two ways to install the driver into an upgraded kernel. The method you use

Driver for Linux -Troubleshooting Section Page 114elx_mes0227: Node Authentication timeoutDESCRIPTION: The driver has lost track of what NPORTs are be

Driver for Linux -Troubleshooting Section Page 115elx_mes0235: Deferred RSCNDESCRIPTION: The driver has received multiple RSCNs and has deferred the p

Driver for Linux -Troubleshooting Section Page 116elx_mes0241: NameServer rsp errorDESCRIPTION: The driver received a NameServer response containing a

Driver for Linux -Troubleshooting Section Page 117elx_mes0248: Cancel Discovery Timer state <hba_state>DESCRIPTION: Cancel the device discovery

Driver for Linux -Troubleshooting Section Page 118elx_mes0305: Mbox cmd cmpl error - RETRYingDESCRIPTION: A mailbox command completed with an error st

Driver for Linux -Troubleshooting Section Page 119elx_mes0311: Mailbox command <cmd> cannot issueDESCRIPTION: The driver is in the wrong state t

Driver for Linux -Troubleshooting Section Page 120elx_mes0316: Cmd ring <ringno> put: iotag <iotag> greater then configured max <fast_i

Driver for Linux -Troubleshooting Section Page 121elx_mes0322: Ring <ringno> handler: unexpected completion IoTag <IoTag> DESCRIPTION:The

Driver for Linux -Troubleshooting Section Page 122elx_mes402: N/ADESCRIPTION: N/ADATA: N/ASEVERITY: N/ALOG: N/AMODULE: N/AACTION: N/Aelx_mes403: N/ADE

Driver for Linux -Troubleshooting Section Page 123elx_mes0408: N/ADESCRIPTION: N/ADATA: N/ASEVERITY: N/ALOG: N/AACTION: N/Aelx_mes0409: Memory Buffer

Driver for Linux - Installation Section Page 7Removing a Previous 7.x Version of the DriverTo completely remove a previous 7.x version of the driver:

Driver for Linux -Troubleshooting Section Page 124elx_mes0414: N/ADESCRIPTION: N/ADATA: N/ASEVERITY: N/ALOG: N/AACTION: N/Aelx_mes0415: N/ADESCRIPTION

Driver for Linux -Troubleshooting Section Page 125elx_mes0421: N/ADESCRIPTION: N/ADATA: N/ASEVERITY: N/ALOG: N/AACTION: N/Aelx_mes0422: N/ADESCRIPTION

Driver for Linux -Troubleshooting Section Page 126elx_mes0428: N/ADESCRIPTION: N/ADATA: N/ASEVERITY: N/ALOG: N/AACTION: N/Aelx_mes0429: N/ADESCRIPTION

Driver for Linux -Troubleshooting Section Page 127SEVERITY: Error configLOG: alwaysACTION: Make neccessary changes to the lpfc configuration file.elx_

Driver for Linux -Troubleshooting Section Page 128elx_mes0436: Adapter failed to init, timeout, status reg <status>DESCRIPTION: The adapter fail

Driver for Linux -Troubleshooting Section Page 129elx_mes0442: Adapter failed to init, mbxCmd <cmd> CONFIG_PORT, mbxStatus <status>DESCRIP

Driver for Linux -Troubleshooting Section Page 130elx_mes0448: Adapter failed to init, mbxCmd <cmd> READ_SPARM, mbxStatus <status>DESCRIPT

Driver for Linux -Troubleshooting Section Page 131elx_mes0454: Adapter failed to init, mbxCmd <cmd> INIT_LINK, mbxStatus <status>DESCRIPTI

Driver for Linux -Troubleshooting Section Page 132elx_mes0460: Bring adapter offlineDESCRIPTION: The FC driver has received a request to bring the ada

Driver for Linux -Troubleshooting Section Page 133elx_mes0703: Issue LUN Reset to TGT <num> LUN <num>DESCRIPTION: The SCSI layer detected

Driver for Linux - Installation Section Page 8Removing a 4.x or 1.x Version of the DriverIf the driver is installed as a module, do the following to r

Driver for Linux -Troubleshooting Section Page 134elx_mes0716: FCP residual underrun, expected <len>, residual <resid>DESCRIPTION: An FCP

Driver for Linux -Troubleshooting Section Page 135elx_mes0726: N/ADESCRIPTION: N/ADATA: N/A SEVERITY: N/ALOG: N/AMODULE: N/AACTION: N/Aelx_mes0727: N/

Driver for Linux -Troubleshooting Section Page 136elx_mes0733: N/ADESCRIPTION: N/ADATA: N/A SEVERITY: N/ALOG: N/AACTION: N/Aelx_mes0734: FCP read chec

Driver for Linux -Troubleshooting Section Page 137elx_mes0740: N/ADESCRIPTION: N/ADATA: N/A SEVERITY: N/ALOG: N/AACTION: N/Aelx_mes0741: N/ADESCRIPTIO

Driver for Linux -Troubleshooting Section Page 138elx_mes0747: Cmpl target resetDESCRIPTION: A driver-initiated target reset completed.DATA: (1) scsi_

Driver for Linux -Troubleshooting Section Page 139elx_mes0754: SCSI timeout DESCRIPTION: An FCP IOCB command was posted to a ring and did not complete

Driver for Linux -Troubleshooting Section Page 140elx_mes0905: Add NPort <did> to ADISC listDESCRIPTION: The driver is putting the node table en

Driver for Linux -Troubleshooting Section Page 141elx_mes0912: N/ADESCRIPTION: N/AN/ASEVERITY: N/ALOG: N/AMODULE: N/AACTION: N/Aelx_mes0913: N/ADESCRI

Driver for Linux -Troubleshooting Section Page 142elx_mes0918: N/ADESCRIPTION: N/ADATA: N/ASEVERITY: N/ALOG: N/AACTION: N/Aelx_mes0919: N/ADESCRIPTION

Driver for Linux -Troubleshooting Section Page 143elx_mes0925: N/ADESCRIPTION: N/ADATA: N/ASEVERITY: N/ALOG: N/AACTION: N/Aelx_mes0926: N/ADESCRIPTION

Driver for Linux - Installation Section Page 95. Edit /usr/src/linux/drivers/net/Space.c to remove the following lines if they are present:extern int

Driver for Linux -Troubleshooting Section Page 144elx_mes0932: FIND node did <did> NOT FOUNDDESCRIPTION: The driver was searching for a node tab

Driver for Linux -Troubleshooting Section Page 1451104 TMc message: Config line <num> starting LUN number <num> should be evenDESCRIPTION:

Driver for Linux -Troubleshooting Section Page 1461108 TMc message: Config line <num> starting LUN <num> > max LUN <num>.DESCRIPT

Driver for Linux -Troubleshooting Section Page 1471113 TMc message: Config line <num> starting LUN <num> + od-ev LUN (cnt <cnt> * 2)

Driver for Linux -Troubleshooting Section Page 1481117 TMi message: HBA <num> LUNs Ready <total> last LUN <num>DESCRIPTION: Display

Driver for Linux -Troubleshooting Section Page 1491121 TMe message: LUN <num> alloc error, unknown retStatusDESCRIPTION: During LUN population,

Driver for Linux -Troubleshooting Section Page 1501126 TMw message: Config line <num> starting LUN number <num> should be oddDESCRIPTION:

Driver for Linux -Troubleshooting Section Page 151elx_mes1203: N/ADESCRIPTION: N/ADATA: N/ASEVERITY: N/ALOG: N/AACTION: N/Aelx_mes1204: lpfc_kmalloc:

Driver for Linux -Troubleshooting Section Page 152elx_mes1208: C_CT request errorDESCRIPTION: The CT response returned more data than the user buffer

Driver for Linux -Troubleshooting Section Page 153Link Events (1300 - 1399)elx_mes1300: Re-establishing Link, timer expiredDESCRIPTION: The driver det

Driver for Linux - Installation Section Page 10Removing a 2.x Version of the DriverIf the driver is installed as a module, do the following to remove

Driver for Linux -Troubleshooting Section Page 154elx_mes1305: Link Down Event <eventTag> receivedDESCRIPTION: A link down event was received.DA

Driver for Linux -Troubleshooting Section Page 1551402 SLe message: Command ring <num> timeoutDESCRIPTION: An IOCB command was posted to a ring

Driver for Linux -Troubleshooting Section Page 156elx_mes1605: Issue Report LUN on NPort <nlp_DID>DESCRIPTION:The driver issued an Ioctl REPORT_

Driver for Linux - Installation Section Page 115. Edit /usr/src/linux/drivers/net/Space.c to remove the following lines if they are present:#ifdef CON

Driver for Linux - Installation Section Page 12Installing the UtilitiesInstalling HBAnyware and lputilFollow these instructions to install HBAnyware a

Driver for Linux - Installation Section Page 13Uninstalling the UtililitiesFollow these instructions to uninstall the utilities.Uninstalling the HBAny

Driver for Linux - User Manual Page iiCopyright© 2005 Emulex Corporation. All rights reserved worldwide. No part of this document may be reproduced by

Driver for Linux - Configuration Section Page 14Configuration IntroductionThe Emulex driver for Linux has many options that can be modified to provide

Driver for Linux - Configuration Section Page 15Start HBAnyware in Local Element Manager ModeThe HBAnyware utility can also be launched with a command

Driver for Linux - Configuration Section Page 16HBAnyware Window Element DefinitionsThe HBAnyware window contains five basic components: the menu bar,

Driver for Linux - Configuration Section Page 17The toolbar is visible by default. Use the Toolbar item in the View menu to hide the toolbar. If the i

Driver for Linux - Configuration Section Page 18The Discovery TreeThe discovery tree (left pane) displays icons representing discovered network (SAN)

Driver for Linux - Configuration Section Page 19• The HBA on a local host is busy performing a local firmware download and is tempo-rarily inaccessibl

Driver for Linux - Configuration Section Page 20List HBAsSyntax: ./hbacmd LISTHBAS (This command is not case sensitive.)Description: A list of the dis

Driver for Linux - Configuration Section Page 21Set Persistent BindingSyntax: ./hbacmd SetPersistentBinding <wwpn> <scope> <bindtype>

Driver for Linux - Configuration Section Page 22Set BootBIOSSyntax: ./hbacmd SetBootBios <wwpn> <ctrlword>Description: This function is us

Driver for Linux - Configuration Section Page 23HBA TasksDiscover HBAs You can discover adapters using either HBAnyware or lputil.• HBAnyware allows

Table of ContentsDriver for Linux - User Manual Page iiiInstallation...

Driver for Linux - Configuration Section Page 24Configuring Discovery SettingsUsing the HBAnyware Discovery Settings dialog box, you can configure the

Driver for Linux - Configuration Section Page 25From the Main menu, enter 1, List Adapters.Figure 6: The lputil Main MenuSort HBA InformationSort HBAs

Driver for Linux - Configuration Section Page 26• If multiple HBAs have the same model number, sorts models by world wide node name.• If targets are p

Driver for Linux - Configuration Section Page 272. Click Discovered Elements in the discovery tree.Figure 7: The HBAnyware Discovered Elements TabDisc

Driver for Linux - Configuration Section Page 283. Click a host name in the discovery tree.Figure 8: The HBAnyware Host Attributes TabGeneral Area Fie

Driver for Linux - Configuration Section Page 293. Click a target in the discovery tree.Figure 9: The HBAnyware Target Attributes TabTarget Attributes

Driver for Linux - Configuration Section Page 303. Click a LUN in the discovery tree.Figure 10: The HBAnyware LUN Attributes TabLun Attributes Field D

Driver for Linux - Configuration Section Page 31View Fabric AttributesThe Fabric Attributes tab in HBAnyware contains information specific to the sele

Driver for Linux - Configuration Section Page 323. Click an HBA in the discovery tree.Figure 12: The HBAnyware General Attributes TabAdapter Summary F

Driver for Linux - Configuration Section Page 33• Diagnostic Mode - the HBA is controlled by a diagnostic program.• Link Down - there is no access to

Table of ContentsDriver for Linux - User Manual Page ivSort Local HBAs Only Using HBAnyware... 26Sort L

Driver for Linux - Configuration Section Page 34• Description - a formal description of the HBA, including model number, bus type and link speed.• Dri

Driver for Linux - Configuration Section Page 354. Click the Port tab.Figure 14: The HBAnyware Port TabPort Field Definitions• Node WWN - a 64-bit wor

Driver for Linux - Configuration Section Page 36• Supported Speed - maximum link speed supported by the HBA.• Current Speed - link speed for the curre

Driver for Linux - Configuration Section Page 37• Tx Sequences - Fibre Channel sequences transmitted by this HBA port.• Link Failures - the number of

Driver for Linux - Configuration Section Page 38View Firmware InformationUse the Firmware tab to view current firmware versions and update firmware on

Driver for Linux - Configuration Section Page 39View Target MappingUse this tab to perform mapping and persistent binding tasks. See page 67 to learn

Driver for Linux - Configuration Section Page 40• Change Settings - click to change the Bind Type, the mode used to persistently bind target mappings.

Driver for Linux - Configuration Section Page 413. Click the Driver Parameters tab (Figure 18). The Installed Driver Types field displays the driver t

Driver for Linux - Configuration Section Page 423. Click the Host Driver Parameters tab (Figure 19). The Installed Driver Types drop-down box displays

Driver for Linux - Configuration Section Page 434. Navigate to the /usr/src/lpfc directory and rebuild the driver. Type:enter make clean lpfc install5

Table of ContentsDriver for Linux - User Manual Page vUnderstand Device Numbering...

Driver for Linux - Configuration Section Page 44Select choice #2. Figure 21: The Adapter MenuIf you have multiple adapters, a list is displayed, you s

Driver for Linux - Configuration Section Page 45• From the menu bar, click Adapter, and then click Reset Adapter.• Click the Reset toolbar button.4. A

Driver for Linux - Configuration Section Page 46Update FirmwareYou can update firmware using either HBAnyware or lputil. • HBAnyware allows you to upd

Driver for Linux - Configuration Section Page 474. On the Firmware tab, click the Update Firmware button. The HBAnyware Firmware Download dialog box i

Driver for Linux - Configuration Section Page 482. The Batch Firmware Download dialog box is displayed.Figure 24: The HBAnyware Batch Firmware Downloa

Driver for Linux - Configuration Section Page 49Update Firmware Using lputilPrerequisites • The driver for Linux (including lputil) is installed prope

Driver for Linux - Configuration Section Page 50Boot CodeBoot code allows you to designate a Fibre Channel drive as the boot device. Linux supports th

Driver for Linux - Configuration Section Page 514. Browse to the directory into which you extracted the boot code file. Select the file to download an

Driver for Linux - Configuration Section Page 52Figure 27: Batch Firmware Download Window, Download Complete7. Click Close to exit the batch procedure

Driver for Linux - Configuration Section Page 53Create a Fibre Channel Remote Boot DiskComplete the following procedure to create a Fibre Channel boot

Table of ContentsDriver for Linux - User Manual Page viHBAnyware Security Configurator Situations - Backup Masters... 98Error Messa

Driver for Linux - Configuration Section Page 544. Make file systems ext3 and label the file systems:tune2fs -j -L /boot /dev/sda2tune2fs -j -L / /dev

Driver for Linux - Configuration Section Page 55Configure the DriverYou can configure the driver using HBAnyware or lpfc.conf.Configure Driver Paramet

Driver for Linux - Configuration Section Page 564. Click the Driver Parameters tab. The Installed Driver Types field displays the driver operating sys

Driver for Linux - Configuration Section Page 574. Click the Host Driver Parameters tab. The Installed Driver Types drop-down box displays a list of a

Driver for Linux - Configuration Section Page 58Restore All Parameters to Their Earlier ValuesIf you have made changes to parameters and have not save

Driver for Linux - Configuration Section Page 59Example of Permanent Global ConfigurationYou want to set lun_queue_depth to 20 (default is 30) for all

Driver for Linux - Configuration Section Page 608. When the make finishes successfully, type:insmod lpfcinsmod lpfcdfc9. HBAnyware services will start

Driver for Linux - Configuration Section Page 61Example of Temporary Per Adapter ConfigurationYou want to temporarily set lun_queue_depth to 20 (defau

Driver for Linux - Configuration Section Page 62• <L> represents the LUN number of the newly added LUN.To dynamically add LUNs and targets with

Driver for Linux - Configuration Section Page 63• PCI configuration region 1• PCI configuration region 26. Upon completion, press 0 to return to Main

Driver for Linux - Installation Section Page 1Installation Driver InformationSupported Features• Supports 256 LUNs (0-255)• Supports dynamically addin

Driver for Linux - Configuration Section Page 64lpfc_cr_delay 0 0 63 This parameter determines the values for I/O coalescing for cr_delay (msec) or cr

Driver for Linux - Configuration Section Page 65lpfc_link_speed 0 0=auto select1=1G2=2G4=4GSets link speed.lpfc_log_verbose 0x0 0x0 0xffff (bit mask)

Driver for Linux - Configuration Section Page 66The 'devlabel' ToolThe devlabel tool provided by Red Hat for Red Hat Enterprise Linux 3 mana

Driver for Linux - Configuration Section Page 673. Click a target in the discovery tree.4. Click on the Target Mapping tab.Figure 30: The HBAnyware Ta

Driver for Linux - Configuration Section Page 684. Target mappings are displayed by world wide port name (WWPN), world wide node name (WWNN), device I

Driver for Linux - Configuration Section Page 693. Select the Bind Type that you want to use (WWPN, WWNN or D_ID).4. Select the Bus ID and Target ID t

Driver for Linux - Configuration Section Page 70HBAnyware SecurityIntroductionAfter HBAnyware, which includes the HBAnyware utility and remote server,

Driver for Linux - Configuration Section Page 71ProcedureTo start the HBAnyware Security Configurator:1. Run the /usr/sbin/hbanyware/ssc script. Type:

Driver for Linux - Configuration Section Page 723. Select the unsecured servers that you want to add to the ACG from the Available Servers list.Figure

Driver for Linux - Configuration Section Page 73When you select systems in the ACG and move them to the Available Servers list, the security configura

Driver for Linux - Installation Section Page 2Compatibility• LPe11000, LPe11002 and LPe1150 (minimum firmware version 2.50a2)• LP11000, LP11002 and LP

Driver for Linux - Configuration Section Page 74ACG IconsDepending on the configured security topology, a system can be a server in one or more ACGs.

Driver for Linux - Configuration Section Page 752. Select the unsecured servers that you want to add to the ACG from the Available Servers list.Figure

Driver for Linux - Configuration Section Page 762. On the Access Control Group tab, from the Available Servers list, select the unsecured servers that

Driver for Linux - Configuration Section Page 772. On the Access Control Group tab, from the Access Control Group Servers list, select the secured sys

Driver for Linux - Configuration Section Page 781. Start the HBAnyware Security Configurator. The Access Control Group tab is displayed.Figure 42: The

Driver for Linux - Configuration Section Page 79To generate new security keys for all servers in the ACG:1. From the MSC, start the HBAnyware Security

Driver for Linux - Configuration Section Page 80Restore the ACG to Its Last Saved ConfigurationYou can restore the ACG to its last saved configuration

Driver for Linux - Configuration Section Page 812. From the Access Control Group tab, check Enable Switch Access.Figure 46: The Access Control Group T

Driver for Linux - Configuration Section Page 82Figure 47: The Access Sub-Groups TabASG IconsThe following icons indicate the state of each of the ser

Driver for Linux - Configuration Section Page 83To create an ASG:1. Start the HBAnyware Security Configurator.2. Click the Access Sub-Groups tab.Figur

Driver for Linux - Installation Section Page 3Installing the Driver KitThe lpfc-install script installs both the lpfc driver and the lpfcdfc driver RP

Driver for Linux - Configuration Section Page 84Reserved Indices - ExamplesA particular security installation can support the creation of several hund

Driver for Linux - Configuration Section Page 85Deleting an ASGOnly a leaf node ASG may be deleted (i.e. not ASGs underneath it in the tree). If an AS

Driver for Linux - Configuration Section Page 862. Click the Access Sub-Group tab.Figure 52: The Access Sub-Groups Tab3. Select the ASG you want to ed

Driver for Linux - Configuration Section Page 876. Click OK in the Edit Access Sub-Group dialog box to save your changes.About Offline ASGsSometimes a

Driver for Linux - Configuration Section Page 88When the Configurator runs on a Backup Master, the Access Control Group tab looks like the tab on a no

Driver for Linux - Configuration Section Page 89Backup Master Tab and ControlsThe first time the Backup Master tab is selected on the MSC, it looks si

Driver for Linux - Configuration Section Page 90Reassign a Backup Master as the New MSC from the Old MSCBecause a Backup Master may have to take over

Driver for Linux - Configuration Section Page 912. Click the Backup Master tab.Figure 59: The Backup Master “Warning” Dialog Box3. Click Assign This S

Driver for Linux -Troubleshooting Section Page 92TroubleshootingIntroductionThere are several circumstances in which your system may operate in an une

Driver for Linux -Troubleshooting Section Page 93Driver uninstall fails. The lpfc-install- -uninstall script fails with an error.Try the following sol