Home

Emulex® Drivers for Linux User Manual

1. P007633 01B Rev A gt G EMULEX 3 Configuration 21 FC and FCoE Driver Configuration Dynamic FC and FCoE Driver Parameters Changes to the dynamic parameters take affect immediately All LPFC dynamic parameters are read write using sysfs Table 3 2 lists the dynamic FC and FCoE driver parameters Table 3 2 Dynamic FC and FCoE Driver Parameters Parameter lpfc_cr_count Description For LightPulse adapters this parameter determines the value for I O coalescing for lpfc_cr_count outstanding commands The minimum value is 1 default The maximum value is 255 Note For OneConnect UCNAs this parameter is not applicable ipfc_cr_delay For LightPulse adapters this parameter determines the value for 1 0 coalescing for lpfc_cr_delay milliseconds outstanding commands The minimum value is 0 default The maximum value is 63 Note For OneConnect UCNAs this parameter is not applicable ipfc_devloss_tmo Specifies the number of seconds to hold an I O error when a device disappears The minimum value is 0 The maximum value is 255 The default value is 30 ipfc_enable_auth Specifies whether DHCHAP support is enabled When set to 1 DHCHAP is enabled When set to 0 DHCHAP is disabled Note This property requires a link reset to activate Note This parameter is applicable to FC 8 2 0 x drivers only ipfc_fdmi_on Specifies the type of FDMI support The enabled values are 1 or 2 dependi
2. Port 0 Port 1 OneConnect 10 GbE UCNA Speed Gb s Speed Gb s Port Link Status Speed Gb s 10 10 Both ports are link up 10 10 1 Only Port 0 is link up 10 1 10 Only Port 1 is link up 10 1 1 Both ports are link up 1 1 Only Port 0 is link up 1 1 Only Port 1 is link up 1 10 Only Port 0 is link up 10 10 Only Port 1 is link up 10 Port Speed on UCNA Mezzanine Cards For UCNA mezzanine cards only one Ethernet port speed is supported at a time Its speed is the first negotiated speed either 1 Gb s or 10 Gb s depending on the switch that is connected To change the speed on these cards 1 Remove the switch from both of the ports 2 Insert the switch for one port and wait for the link to come up The UCNA retains this speed until both links are down Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Appendix D Updating Ethernet Firmware 142 Appendix D Updating Ethernet Firmware The be2net driver supports updating the firmware image in the UCNA flash through the request_firmware interface in Linux You can perform this update when the UCNA is online and passing network storage traffic To update the ethernet firmware image 1 Copy the latest firmware image under the lib firmware directory cp be3flash ufi lib firmware Start the update process e In Linux distributions that support the flash option in ethtool for example SLES 11 SPx and RHEL 6 x use the following command
3. 2539 Dropped frame rctl s type s n An unsupported frame was received by the port and dropped Data 1 rctl_names fc_hdr gt fh_r_ctl 2 type_names fc_hdr gt fh_type Severity Error Log Always Action No action needed informational 2540 Ring lt ring gt handler unexpected Rctl lt fh_rctl gt Type lt fh_type gt The received frame has an unsupported RCTL or FH_TYPE Data None Severity Warning Log LOG_SLI Action None required 2541 Mailbox command lt vpi gt lt mbxCommand gt cannot issue Data 1 sli_mbox_opcode 2 sli_flag 3 flag Severity Error Log LOG_MBOX LOG_SLI Action None required 2542 Try to issue mailbox command lt vpi gt lt mbxCommand gt synchronously ahead of async mailbox command queue Attempting to send a synchronous mailbox command ahead of the asynchronous mailbox commands Data 1 sli4_mbx_opcode or sli_mbox_opcode 2 sli_flag 3 flag Severity Warning Log LOG_MBOX LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 122 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2543 Mailbox command lt vpi gt lt mbxCommand gt cannot issue The mailbox command does not have all of the fields set correctly Data 1 sli_mbox_opcode 2 sli_flag 3 flag Severity Error Log LOG_MBOX LOG_SLI Action None required 2544 Mailbox command
4. ethtool f eth lt X gt be3flash ufi 0 e In older Linux distributions for example SLES 10 SPx and RHEL 5 x write the name of the flash image file in the sysfs node echo 60 gt sys class firmware timeout echo be3flash ufi gt sys class net eth lt xX gt flash_fw Reboot the system to enable the new firmware image to take effect Emulex Drivers for Linux User Manual P007633 01B Rev A
5. 1049 Authentication is enabled but authentication service is not running Discovery failed because DHCHAP Authentication was enabled while no authentication service was established Data None Severity Error Log LOG_SECURITY Action Start the authentication daemon fcauthd elx msgl050 Authentication mode is disabled but is required by the fabric Discovery failed because the switch fabric required authentication but authentication was not configured or the authentication mode for this port pair is disabled Data None Severity Error Log LOG_SECURITY Action Configure the driver to authenticate with the switch or disable authentication on the switch to this port Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 99 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1053 Start Authentication Security service offline The authentication failed because security service was unavailable Data None Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1055 Authentication parameter is disabled but is required by the fabric FLOGI failed because the fabric has indicated that authentication is required but authentication has not yet been configured or enabled on the HBA Data None Severity Error Log LOG_SECURITY Action Configure authentication on th
6. lt HeaderDigest gt Emulex Drivers for Linux User Manual Replace with either E or D E denotes that the header digest is enabled D denotes that the header digest is disabled Optional P007633 01B Rev A ys is Appendix B Configuring iSCSI Through DHCP 139 gt lt EMULEX DHCP Option 43 Vendor Specific Information Table B 1 DHCP Option 43 Vendor Specific Information Parameter Description Field Type lt DataDigest gt Replace with either E or D Optional e E denotes that the data digest is enabled e D denotes that the data digest is disabled If a value is not provided it is assumed that the Data Digest is disabled by default lt AuthenticationType gt If applicable replace with D E or M Optional e D denotes that authentication is disabled e E denotes that one way CHAP is enabled the username and secret to be used for one way CHAP must be specified by non DHCP means e M denotes that mutual CHAP is enabled user name and passwords required for mutual CHAP authentication must be specified by non DHCP means If a value is not specified this field defaults to authentication disabled DHCP Option 43 Format The following is the format of DHCP option 43 and its guidelines for creating the data string iscsi lt TargetIP gt lt TargetTCPPort gt lt LUN gt lt TargetName g
7. is 4 Troubleshooting 69 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0322 Ring lt ringno gt handler unexpected completion IoTag lt IoTag gt The driver could not find a matching command for the completion received on the specified ring Data 1 ulpStatus 2 ulpWord 4 3 ulpCommand 4 ulpContext Severity Warning Log LOG_SLI verbose Action This error could indicate a software driver or firmware issue If this issue persists report these errors to Technical Support 0323 Unknown Mailbox command lt mbxCommand gt Cmpl A unknown mailbox command completed Data None Severity Error Log Always Action This error could indicate a software driver firmware or hardware issue Report these errors to Technical Support 0324 Config port initialization error mbxCmd lt mbxCommand gt READ NVPARM mbxStatus lt mbxStatus gt READ_NVPARMS mailbox command failed during port configuration Data None Severity Error Log Always Action This error could indicate a software driver firmware or hardware issue Report these errors to Technical Support 0328 Rsp Ring lt ring number gt error IOCB Data The firmware has returned an error for this IOCB Data 1 lt iocb word 0 iocb word 7 gt 2 lt rsp word 0 rsp word 7 gt Severity Warning Log LOG_SLI Action None required 0330 IOCB wake NOT set The completion handler associated with
8. 1410 Failed to set up pci memory space Initialization failed to set up PCI memory space Data None Severity Error Log LOG_INIT Action None required 1411 Failed to set up driver resource Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 4 Troubleshooting 107 Log Messages 1412 Failed to set up driver resource Initialization failed to set up driver resource Data None Severity Error Log LOG_INIT Action None required 1413 Failed to initialize iocb list Initialization failed to initialize the IOCB list Data None Severity Error Log LOG_INIT Action None required 1414 Failed to set up driver resource Initialization failed to set up driver resource Data None Severity Error Log LOG_INIT Action None required 1415 Failed to create scsi host Initialization failed to create SCSI host Data None Severity Error Log LOG_INIT Action None required 1416 Failed to allocate sysfs attr Initialization failed to sysfs attribute Data None Severity Error Log LOG_INIT Action None required 1418 Invalid HBA PCI device group lt dev_grp gt Invalid HBA PCI device group detected Data None Severity Error Log LOG_INIT Action None required 1419 Invalid HBA PCI devic
9. 3 or Very Conservative im_policy 4 setting may be more desirable Though these settings increase the latency of an I O request the lowered interrupt rate may allow the system to be functional under a high load Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 33 gt EMULEX iSCSI Driver Configuration iSCSI Error Handling Error Handling using ETO and LDTO Parameters The goal of iSCSI error handling is to be tolerant of link level and target level failures up to configured timeout values so that I O errors are not seen by the application or operating system The error handling is triggered under the following conditions e Loss of connection to the target due to target and or network disconnection at the target If the driver has I O requests pending with the target and the target becomes unavailable due to target going down or failing over or network issues at the target the driver queues up the I O requests internally for a configured period of time The threshold value of this period is the ETO value e Loss of immediate link to the initiator such as cable disconnect or port failure The UCNA firmware detects and notifies the driver of a loss of the link When this happens the driver queues up the I O requests internally to a configured period of time so that the operating system does not see I O errors The threshold value of this period is the LDTO value When the configured ETO or LD
10. Action SLI 3 mode is only available on some HBAs Do not attempt to force the SLI mode to 3 on HBAs that do not support SLI 3 mode This is an informational message HBAs that do not support SLI 3 will be configured to run in SLI 2 mode but it is recommended to use the auto setting 0 1821 Create VPORT failed Invalid WWN format The port could not be created due to an invalid WWNN or WWPN format Data None Severity Error Log LOG_VPORT verbose Action Provide a valid WWN when creating Vports 1822 Invalid lt name gt lt xx XxX XX XK XX XXI XXI XK gt An invalid WWN was used when creating a VPort Data 1 type_name 2 wwn 1 3 wwn 3 3 wwn 5 4 wwn 7 Severity Error Log LOG_VPORT verbose Action When creating a VPort you must furnish a valid WWN 1823 Create VPORT failed Duplicate WWN on HBA The port could not be created because it would duplicate an existing WWNN HBA address The resources for the port had to be discarded Data None Severity Error Log LOG_VPORT verbose Action Provide a WWN that is unique 1824 NPIV enabled Override lpfc_sli_mode parameter lt mode gt to auto 0 The lpfc_enable_npiv and lpfc_sli_mode driver parameter settings conflict The HBA must be configured for SLI 3 mode to support NPIV Data 1 lpfc_sli_mode Severity Error Log LOG_VPORT verbose Action This is an informational message that indicates that the lpfc_enable_npiv and pfc_sli_mod par
11. Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0438 Adapter failed to init chipset status reg lt status gt The adapter failed during power up diagnostics after it was reset Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0439 Adapter failed to init mbxCmd lt mbxCommand gt READ REV mbxStatus lt mbxStatus gt Adapter initialization failed when issuing a READ_REV mailbox command Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0440 Adapter failed to init READ REV has missing revision information A firmware revision initialization error was detected Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue Install the latest firmware revision If this issue persists report the error to Technical Support P007633 01B Rev A is 4 Troubleshooting 82 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0442 Adapter failed to init mbxCmd lt mbxCommand gt CONFIG PORT mbxStatus lt mbxStatus gt Adapter initialization failed when issuing a CONFIG_PORT mailbox command Data
12. In other words hostY is the new host created for the new VPort vport X 0 Z uniquely identifies the VPort and indicates the parent host structure X that this VPort was created by For example if a VPort is created from host5 a new scsi_host a new fc_host a new fc_vport and a new entry under the bus tree are created as well ls sys class scsi_host hostO hostl host4 host5 host6 ls sys class fc_host host4 host5 host6 ls sys class fc_vports vport 5 0 0 Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX VPort sysfs Entries 3 Configuration Virtual Port VPort Configuration Note VPort sysfs entries in Table 3 6 are only present if the driver was loaded with lpfc_enable_npiv enabled Table 3 6 VPort sysfs Entries VPort sysfs Entries lpfc_peer_port_ login Type Read Write Range nput 0 Off default 1 On Location and Description sys class scsi_ host hostX lpfc_ peer port log in This entry sets the port s behavior when discovering targets in the SAN The default behavior value 0 will login only to N_Ports that are physically located on a different port The port will still attempt to log in to targets on all other ports including the other port in a dual port adapter If this parameter is turned on value 1 then the port attempts to log in to all N_Ports even if they are physically located on the same port Note This parameter was created to
13. With SLES11 SP1 you cannotupdate an iSCSI v2 0 driver to an iSCSI v2 3 or 2 4 driver using the elx_iscsi_install sh script provided with the package Emulex Drivers for Linux User Manual The script indicates the installation is complete but modinfo or the OneCommand Manager application still displays the older version of the driver A system reboot does not update the driver either To work around this issue follow these steps 1 Determine whether your current iSCSI driver is a v2 0 driver by running the following command modinfo be2iscsi The version 2 0 driver usually has a format of 2 102 xxx x 2 Find the location of the driver module under lib by typing find lib name be2iscsi ko print For example the output may look like this lib modules 2 6 32 12 0 7 default updates be2iscsi ko this is th fil 2 102 348 0 lib modules 2 6 32 12 0 7 default kernel drivers scsi be2iscsi be2 iscsi ko modul to remov this is the open be2iscsi do not remove 3 Remove the old module by typing rm f lib modules 2 6 32 12 0 7 default updates be2iscsi ko Install the latest driver via rpm or elx_iscsi_install sh P007633 01B Rev A gt G EMULEX Log Messages FC and FCoE Driver Log Messages 4 Troubleshooting 54 Log Messages Retrieving FC and FCoE Driver Log Messages LPFC error log messages are logged in the var log messages file An example of an LPFC message Jul 2 04 23 34
14. cccccececeeeeeescescceeeeeeeeeeeeeeesessseeuesenennees 47 4 Troubleshooting siiviiaraniwcesduisacsrseaerewacesnuwansnsaddusaradaneeissanedssaneianaeenowe 48 Situations and their Resolutions sssseessssessosscecosesesossecossseceosececoeescossseeoo 48 FC and FCoE Driver Situations and their ResolutionS sssssssesesssesssseesseseee 48 Ethernet Driver Situations and their Resolutions ssssssssessssesessesrossssesessee 52 iSCSI Driver Situations and their Resolutions sesssssssesessssesssssesseseesssssees 53 LOS MOSSAGES fics cases isie ren E T E E S 54 FC and FCoE Driver Log Messages sssesssssessossscsocsseccosesscosseseocosecscsseesoo 54 Retrieving FC and FCoE Driver Log Messages ssssssssesssssessesesesssesesssersessessess 54 LPFC Error Log Messages and their Descriptions sssssssssssessesssessessssssessesseesess 54 Ethernet Driver Log Messages sssnssssseossssssocesesssroseesssecsrsssresersseeese 131 Retrieving Ethernet Driver Log Messages ssssssssessssssssesesesssssseeesesessseese 131 Ethernet Driver Log Messages and their Descriptions sssssssssssssesesssssssseseso 131 ISCSI Driver LOG MESSAgES iireririsiiiis tirni ireti as EEE EEEE EEES 134 Retrieving iSCSI Driver Error Log Messages ssscsssessoossesesessoossesessososssssesoss 134 iSCSI Driver Error Log Messages and their Descriptions ccc eee eee eee eeeeeeeeee 134 Appendix
15. is 4 Troubleshooting 55 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0125 FDISC Failed x x Fabric out of resources The fabric rejected an FDISC because the switch cannot support additional virtual ports Data tsRjtError Severity Error Log Always Action Reconfigure the switch to support more NPIV logins If this issue persists contact Technical Support 0126 FDISC failed ulpStatus ulpWord4 Data tsRjtError Severity Error Log Always Action Reconfigure the switch to support more NPIV logins If this issue persists contact Technical Support 0127 ELS timeout An ELS IOCB command was posted to a ring and did not complete within ULP timeout seconds Data 1 elscmd 2 remote_id 3 ulpcommand 4 ulploTag Severity Error Log Always Action If no ELS command is going through the adapter reboot the system If the issue persists contact Technical Support 0133 PLOGI no memory for reg login Memory allocation error Data 1 nlp_DID 2 nlp_state 3 nlp_flag 4 nlp_rpi Severity Error Log LOG_ELS Action Memory allocation error Check system resources Unload unused modules 0134 PLOGI cannot issue reg login The ELS PLOGI mailbox command has failed Data 1 nlp_DID 2 nlp_state 3 nlp_flag 4 nlp_rpi Severity Error Log LOG_ELS Action Check the port and switch configuration 0135 cannot format reg login Could not allocate a
16. 2 address of cfglink_mbox command Severity Error Log LOG_MBOX Action Attempt to unload and reload the driver when it is convenient 0264 No NPIV Fabric support The switch to which the port is connected does not support NPIV Data None Severity Error Log LOG_ELS Action Check the switch configuration 0266 Issue NameServer Req lt cmdcode gt err lt rc gt Data lt fc_flag gt lt fc_rscn_id_cnt gt The driver was unable to send the NameServer CT command Data 1 vports fc_flag 2 vports fc_rscn_id_cn Severity Error Log LOG_DISCOVERY Action Check the port and switch configurations 0267 NameServer GFF Rsp lt did gt Error lt ulpStatus gt lt un ulpWord 4 gt Data lt fc_flag gt lt fc_rscn_id_cnt gt The NameServer GFF CT request failed Data 1 vports fc_flag 2 vports fc_rscn_id_cnt Severity Error Log LOG_DISCOVERY Action Check the port and switch configurations 0268 NS cmd lt cmdcode gt Error lt ulpStatus gt lt un ulpWord 4 gt The NameServer CT request failed Data None Severity Error Log LOG_DISCOVERY Action Check the port and switch configurations Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 63 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0271 Illegal State Transition node lt nlp DID gt event lt evt gt state lt nlp state gt Data lt nlp rpi
17. Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 72 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0351 Config MSI mailbox command failed mbxCmd lt u mb mbxComm gt mbxStatus lt u mb mbxStatus gt The mailbox command sent to the firmware to configure the adapter to use MSI X has failed Data None Severity Warning Log LOG_MBOX Action Ensure the hardware platform supports MSI X 0352 Config MSI mailbox command failed mbxCmd lt u mb mbxCommand gt mbxStatus lt u mb mbxStatus gt The mailbox command sent to the firmware to configure the HBA to use MSI X has failed Data None Severity Error Log LOG_MBOX Action Ensure the hardware platform supports MSI X 0353 Active Mailbox cleared mailbox timeout exiting The mailbox timeout handler has determined that the driver is in the process of completing this mailbox command Data None Severity Error Log LOG_MBOX LOG_SLI Action None required 0357 MSI X interrupt with no EQE SLI 4 adapter interrupt on the slow path but there is no associated EQE Data None Severity Warning Log LOG_SLI Action None required 0358 MSI X interrupt with no EQE SLI 4 adapter interrupt on the fast path but there is no associated EQE Data None Severity Warning Log LOG_SLI Action None required 0359 Not a val
18. Displaying VPorts Using the Isvport sh Script ssssssssessesssessesssessesssssssssesseesees 35 VPOrE SYSTS scsscceescediceseecsvedeasoecetacuedaeds Ue buleaee ESTRE CERE E RECE ER E aa 35 VPort SysfS TEE sienien aniis esas nnan EREKE ETEO NERE TR S 35 VPOrt SySfS ENTES uence e eE E E EE E EE EE 37 Monitoring VPorts with fc_vport FC and FCoE Drivers sssssssssesesssesseseessese 39 For FC 8 20 X Drivers anneni sineto iEn aana EEEE EOE EES 39 For FC 8 3 5 X DriVerS scwsnsiciceins vee saaic win daica tna vewele seine ad UE EA EERE EER EREE 39 VPort Configuration LIMItS csrosriciseieosreiisisireii rit irris E I EEE EEEa 40 DHCHAP Authentication and Configuration ccccccccccccccccccccccccceccccsccsscees 41 Enabling Authentication ssessssssesosessssossesseossessesosersseossessseoseesseesseso 41 fca thd DACMON sisscccddscesidaranvevateevhesewindewnetensiiasdineweadanbenevaraessacedacdavenne 41 fcauthd Daemon ParaMete ccccessccecscceessceeeseeeeeseeeesseeeesaeeeseeeesaeeeseaees 4 lpfc_enable_auth Module Parameter sssnsssssesssessssoseesseossessseoseesseesseso 42 Authentication Configuration Parameters sssesesssssssssossesesessserossssesssesee 42 Setting Remote and Local Passwords c ccccccccsccccceesccccecessccceeeesscsesenes 42 Network Performance Tuning ccccecccscccccccccccccccccccccccccccsccceceeccccsscscsses 42 Memory Bandwidth Considerations cc
19. FCoE command failed because it could not find the resource Data 1 current offset 2 previous offset 3 count 4 last count 5 address low 6 address high Severity Error Log LOG_LIBDFC Action No action needed informational 1238 FCoE IOCB failed off lt gt rc lt gt The command generated by the driver to check the FCoE has failed Data 1 offset 2 return code Log LOG_LIBDFC Severity Error Action Make sure link is up or the adapter has set menlo in maintenance mode Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 102 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1240 Unable to allocate command buffer memory Could not allocate memory for the command buffer Data None Severity Error Log LOG_LINK_EVENT Action None required 1243 Menlo command error code d n mlorsp gt code The Menlo maintenance command failed Data None Severity Error Log LOG_LINK_EVENT Action None required 1244 Unable to allocate response buffer memory Could not allocate memory for the management command response Data None Severity Error Log LOG_LINK_EVENT Action None required 1246 FCoE chip is running golden firmware Update FCoE chip firmware immediately lt fw_type gt The FCoE is running the golden firmware Data 1 firmware type Severity Error Log LOG_LINK_EV
20. Invalid response length tgt lt TGT_ID gt lun lt LUN gt cmnd lt CMD gt rsplen lt RSPLEN gt The response length for this FCP command is not supported Data None Severity Error Log LOG_FCP Action None required 2721 ndlp null for oxid Sx SID x n icmd gt ulpContext dfchba gt ct_ctx tag SID The Node value for this SID is not in the node list Data None Severity Warning Log LOG_ELS Action None required 2726 READ FCF RECORD Indicates empty FCF table The driver requested the firmware provide a list of FCF entries to connect to and the firmware responded that the FCF table is empty Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 131 gt C EMULEX Log Messages Ethernet Driver Log Messages Retrieving Ethernet Driver Log Messages Ethernet driver messages are logged in the var log messages file This log file is an ASCII text file and can be viewed and searched with a text editor such as vim A log file automatically rotates as it gets larger Rotated log files are named messages x where LA x is an integer To search the log file for error messages at the command prompt type cd var log vim messages A message is displayed similar to the following Aug 15 09 57 48 S74 kernel Invalid MTU requested Must be between 256 and 8974 bytes Ethernet Driver Log Messages
21. N_Port ID virtualization Oracle Linux Peripheral Component Interconnect Peripheral Component Interconnect Express PCle physical function process ID port login power on self test Red Hat Enterprise Linux remote port indicator resource package manager registered state change notification receive side scaling storage area network Small Computer System Interface SUSE Linux Enterprise Server Service Level Interface Storage Management Initiative specification symmetric multiprocessing Storage Networking Industry Association Conformance Testing Program simple network management protocol single root I O virtualization Transmission Control Protocol Unbreakable Enterprise Kernel TCP Segmentation Offload universal converged network adapter User Datagram Protocol universal multichannel PCle virtual function vital product data worldwide port name P007633 01B Rev A gt lt EMULEX 2 Installing and Uninstalling 13 General Installation Requirements 2 Installing and Uninstalling General Installation Requirements Prior to driver installation follow these general requirements e Install a supported Emulex adapter in the system Refer to the adapter s installation manual for specific hardware installation instructions e Usea supported operating system The standalone driver kit supports the following distributions o CentOS 5 5 5 6 and 5 7 Intel x86 Intel Itanium2 Intel EM64T AMD64 and PowerPC 64 bi
22. Situations and their Resolutions Table 4 1 FC and FCoE Driver Situations and their Resolutions Continued Situation rmmod fails to unload driver due to device or resource busy Resolution This message occurs when you attempt to remove the driver without first stopping the OneCommand Manager application or the fcauthd daemon when the OneCommand Manager application is installed and running or when FC disks connected to a LightPulse adapter are mounted To resolved this situation 1 Stop the OneCommand Manager application before attempting to unload the driver The script is located in the usr sbin ocmanager directory Type stop ocmanager 2 Unmount any disks connected to the adapter 3 Unload the driver Type rmmod lpfcdfc 4 Type rmmod lpfc An lspci shows recent Emulex adapters as unknown This situation occurs because of the delay of getting new product IDs into the Linux development cycle There is no resolution at this time Slow targets or extended link faults on the storage side may result in storage being marked offline by the mid level and remaining offline not recovered when the link faults are corrected This version of the driver should eliminate this issue However if you experience offline device issues increase the SCSI command timeout to a value greater than or equal to 60 seconds Emulex also provides a script which addresses this issue To access the lun_change_state sh script
23. The mailbox command to add the FCF record has failed Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 119 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2516 DEL FCF of default FCF Index failed mbx status lt rc gt status lt shdr_status gt add_status lt shdr add _status gt The mailbox command to delete the FCF record has failed Data None Severity Error Log LOG_SLI Action None required 2517 Unregister FCFI command failed status d mbxStatus x x rc bf get lpfc_mge status amp mbox gt u mge The driver was unable to unregister the FCFl from the firmware Data None Severity Error Log LOG_SLI Action None required 2518 Requested to send 0 NOP mailbox cmd Data None Severity Warning Log LOG_INIT Action None required 2519 Unable to allocate memory for NOP mailbox command Memory allocation for this mailbox command has failed Data None Severity Error Log LOG_INIT Action None required 2520 NOP mailbox command failed status x x add_status x x mbx status x x shdr_ status shdr_add_status rc The NOP mailbox command has failed Data None Severity Warning Log LOG_INIT Action None required 2521 READ FCF RECORD mailbox failed with status lt shdr_status gt add_status lt shdr_add_
24. These control messages are point to point and are not forwarded by switches or routers The UCNA can respond to flow control packets by temporarily pausing transmits The UCNA can send flow control pause packets when the transmitter is overwhelming the system s receive bandwidth Flow control can greatly improve performance as described in the following examples e The UCNA is installed in 4x PCle slot or an underpowered server system If the PCle bus does not provide 10 Gb s of throughput due to chipset limitations or the bus width the UCNA cannot maintain 10 Gb s of incoming receive data It starts dropping packets quickly In this situation it may be beneficial to enable receive flow control in the UCNA and enable flow control in the attached switch for all devices This helps to slow down the transmitters e The UCNA transmits to 1 Gb s devices especially when using a non TCP protocol If the UCNA transmits to a 10 Gb s switch with attached 1 Gb clients the UCNA may overwhelm the switch The switch is then forced to start dropping packets because although it may receive a 10 Gb s stream the client can only sink a 1 Gb stream In this situation it may be beneficial to enable transmit flow control in the UCNA and enable flow control for the 10 Gb s switch port You can configure the OneConnect UCNA to respond to flow control pause frames from the other side switch or router using the following ethtool commands ethtool A lt ethN gt
25. but not limited to the implied warranties of merchantability or fitness for a particular purpose Emulex may make improvements and changes to the product described in this manual at any time and without any notice Emulex assumes no responsibility for its use nor for any infringements of patents or other rights of third parties that may result Periodic changes are made to information contained herein although these changes will be incorporated into new editions of this documentation Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 OpenSolaris DHCHAP Notice Contains portions of Covered Software subject to the Common Development and Distribution License CDDL Version 1 0 Such portions of Covered Software in Source Code form may be obtained from the website www opensolaris org or by contacting online support from the website www emulex com Derived from the RSA Data Security Inc MD5 Message Digest Algorithm Copyright C 1991 2 RSA Data Security Inc Created 1991 All rights reserved Emulex Drivers for Linux User Manual P007633 01B Rev A gt EMULEX Supported Driver Versions Supported Driver Versions The following table lists the Emulex supported Fibre Channel FC Fibre Channel over Ethernet FCoE Ethernet and internet Small Computer System Interface iSCSI drivers that are applicable in this manual A check mark v indicates the type of driver distrib
26. line For example the following command boots the Linux kernel with the SELinux and auditing options disabled kernel boot vmlinux 2 6 18 ro root dev md0 selinux 0 audit 0 You can get better CPU utilization and in some cases better throughput by disabling kernel debug options such as CONFIG_DEBUG_SLAB This requires you to build the kernel image and modules Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 48 Situations and their Resolutions gt G EMULEX 4 Troubleshooting Situations and their Resolutions This section explains some of the situations in which your system may operate in an unexpected manner and some possible resolutions FC and FCoE Driver Situations and their Resolutions Table 4 1 lists the FC and FCoE driver situations and their resolutions Table 4 1 FC and FCoE Driver Situations and their Resolutions Situation FC link fails to come up Resolution If an FC link fails to come up verify that an 8 or 16 Gb s adapter is not attempting to connect to a 1 Gb s device Only 2 4 and 8 Gb s devices are supported on 8 Gb s adapters Only 2 4 8 and 16 Gb s devices are supported on 16 Gb s adapters For LP21000 series adapters ensure the adapter is not in maintenance mode and it is not running the manufacturing firmware Authentication is enabled but authentication service is not running Error Message If you see this message in var log messages and the adap
27. 0 4 1 425 0 v RHEL 5 6 and later RHEL 6 0 and later SLES 10 SP3 and later SLES 11 SP1 and later XenServer 5 6 XenServer 6 0 Emulex Drivers for Linux User Manual P007633 01B Rev A 3 gt lt EMULEX Supported Driver Versions 4 Driver Distribution Driver Version Inbox DUP DUD Out of Box Supported Operating Systems 4 1 429 0 v XenServer 5 6 and later XenServer 6 0 and later iSCSI Drivers 4 1 334 15 v v RHEL 5 6 RHEL 5 7 RHEL 6 0 and later SLES 10 SP3 and later SLES 11 SP1 4 1 334 39 v RHEL 5 8 SLES 11 SP2 4 1 402 0 v v RHEL 5 6 and later SLES 10 SP3 and later SLES 11 SP1 and later RHEL 6 0 and later Emulex Drivers for Linux User Manual P007633 01B Rev A Table of Contents gt G EMULEX Table of Contents Supported Driver VersionS s essessecsecseeceecoecsececcecceececceececceececceeceeseeseecee 3 Listof Tables ccnissvccsuncwcdaaniecdubauavanesiaverdawashaecaveadanasdvaaudinestadsveotanveigaunie 8 1 Introduction iiss cacasuntecawtsidarsiansvediansaceminiedsmnacnninatees cede seudaeseaseasananews 9 OVEIVICW sircst seciccnansenir ven danesds annua crane ETE EET E s ETE EEEE EEES SE 9 KNOWN ISSUCS iis sec esses eae ii iie ian a EEEREN R T EEEE AKEEKO EA 10 Abpbreviati nS vinci dcnchionuscciet a neenwessebabecssanssadeus encavadensameavenenweanes b a aS aaa 10 2 Installing and Uninstalling seesssessssccssscssecssssosesossccsescssecosesssesose
28. 13 General Installation Requirements sccccsccccccccsccccccsscscceccsscccesessccseessees 13 Binary RPM FC and FCoE Driver Kit esseesesececcceecoeccescsecesecoescseccsoecsoecoeecoe 13 Installing the Binary RPM FC and FCoE Driver Kit sssssssssssnssssesesssesssseesssse 14 Uninstalling the Binary RPM FC and FCoE Driver Kit sssssnssesssessssesssssessesees 14 Ethernet Driver Kitsiictescs tdedensisectvdenveiantedexkecccstdeswataseacwentecetetacvetesvedsevedecds 14 Installing the Ethernet Driver Kit cccc cece cess eeeeeeeeeeeeeeeesseaeaeeeeeeeees 15 Uninstalling the Ethernet Driver Kit ccceeescccceescccceeeseccceessseceeeeseees 15 ISCSI Driver Kt ssisccinsasasiessnscccsdses scesadvienatendanteadseokendesssvessiiavencesaiwncaiesssuns 16 Installing the iSCSI Driver Kit ssccasssccianeetsaincsedevdscarsscacsacecusuesdectiaadevessatueses 16 Uninstalling the iSCSI Driver Kit sssssssssossssesssssosssecocsssesosssscosessosssseoo 16 Booting from a Non Zero LUN Attached to an Emulex LPFC Adapter ss006 17 OneCommand Manager Application eesssesscssseccssecscsseccssseccossccceseeceosseeeoo 17 3 Configuration a vaesuindcekcsinnaen anaa aa a e aa Aaaa S 18 FC and FCoE Driver Configuration sessesecsssscccoosseccosececoecesoessececssscesosesee 18 FC and FCoE Driver Parameters sessessecccsesecsssscoscsecocsssesosseecosssscossseeoo 18 Static FC and FCoE Dr
29. 2 return code Log LOG_LIBDFC Severity Informational Action Retry the command if it fails again reset HBA when convenient Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 101 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1227 FCoE IOCB TMO handler set for lt context3 gt The management command for the LPFC 2100 has timed out Data None Severity Warning Log LOG_LIBDFC Action None required 1228 FCoE IOCB TMO handler set for lt context3 gt A management IOCB for the LPFC 2100 has timed out Data None Severity Warning Log LOG_LIBDFC Action None required 1229 Waiting for menlo mnt Waiting for the LPFC 2100 to enter maintenance method Data None Severity Warning Log LOG_LIBDFC Action None required 1230 Could not find buffer for FCoE cmd off lt gt indmp lt addr gt off lt gt Could not find resources associated with this FCoE command Data 1 current offset 2 buffer desc pointer 3 size Severity Error Log LOG_LIBDFC Action Try reloading the driver when convenient 1231 bad bpl A invalids buffer list was detected upon completion Data None Severity Error Log LOG_LIBDFC Action None required 1235 Could not find buffer for FCoE cmd off lt gt poff lt gt cnt lt gt mlastcnt lt gt addl lt x gt addh lt x gt mdsz lt gt
30. 3 Configuration 29 gt EMULEX Ethernet Driver Configuration Ethernet Driver Configuration Ethernet Driver Configuration Parameters The Ethernet driver supports the user configurable parameters described in Table 3 3 Table 3 3 Ethernet Driver Configuration Parameters Parameter Description num_vfs In systems supporting single root I O virtualization SR IOV when IOV is enabled this parameter indicates the number of PCle virtual functions VFs to be enabled per PCle physical function PF The possible values are 0 to 16 The default value is 0 SR IOV is not enabled rss_on_mc Enables receive side scaling RSS on multichannel functions that have the capability The enabled value is 1 The disabled value is 0 default rx_frag_size The size of fragments used to DMA received data The possible values are 2048 default 4096 and 8192 You can configure Linux to automatically load the driver with any of these options after each reboot To do so add a line to the etc modprobe com file with the required options For example to load the driver with the fragment size of 4096 and create eight VFs per PF in an SR IOV capable system add the following line options be2net rx frag size 4096 num vfs 8 A reboot is required when changing an SR IOV capable system VLAN Support on UMC Up to 63 VLANs can be used with each universal multichannel UMC virtual channel Note You cannot run Link Aggregation Control P
31. A Open iSCSI Support ccccccccccccccccccccccccccccccccccccseccesses 136 Connecting to the iSCSI Target ccccccscccccccccccccccccccccccccccecccceceeccccsssccees 136 EXAMpPl senssucdscenenssanvadetenssen watered I E S E el eke reste el ocak veebeaseeexens 137 Appendix B Configuring iSCSI Through DHCP cescssscccccccccccsssscccces 138 IP Address Reservation sicsciccscdscwcssiaddsvenadcnn thnwnadcnn diswandnecdsawesbessivenetsandnnwes 138 DHCP Option 43 Vendor Specific Information cscccccsccccccssscccccsscsccececes 138 DHCP Option 43 Parameter Descriptions cece cece ce eee teen eeeeeeeeeeeees 138 DHCP Option 43 Format cccicccciessiesccvecedaceceddecduve sus cnedaceeudeeedevecveeceuseess 139 Default Initiator Name and Data Digest Settings Example ceeceeeeeeeeeee eee 139 Default TCP and Mutual CHAP Settings Example ccece eee eeee eee eeeeeeeeeeneeees 140 Appendix C OneConnect 10 GbE UCNA Port Speed Specifications 141 Port Speed Negotiation on Non MeZZanine Cards ccccecccccccccccccceccccceccsces 141 Port Speed on UCNA Mezzanine Cards ecccccceccccecccccccccccccccccccceccccsseecees 141 Appendix D Updating Ethernet Firmware sccccccscscssccccccceccsssscccees 142 Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX List of Tables Table 3 1 Table 3 2 Table 3 3 Table 3 4 Table 3 5
32. AL and fabric with auto topology negotiation and FCoE Supported FC speeds 1 2 4 8 and 16 Gb s FC adapters with auto rate negotiation Note The driver does not support a 1 Gb s rate on 8 or 16 Gb s FC adapters For FC 8 2 0 x drivers supports Fibre Channel Security Protocol FC SP Diffie Hellman Challenge Handshake Authentication Protocol DHCHAP Tested up to 32 adapter ports Dynamic parameter setting using the Emulex OneCommand Manager application as part of a master kit Enabling graphic user interface GUI based driver configuration including in band FC and out of band TCP IP remote storage area network SAN management capability diagnostics loopback and diagnostics dump virtual port support personality change and more 9 gt G EMULEX 1 Introduction 10 Abbreviations For more information about the OneCommand Manager application see the latest OneCommand Manager Application User Manual which is available on the Emulex website Support for common HBA application programming interface API Batch firmware download capability Support for the sysfs Linux virtual file system interface See Configure Parameters with a Read Write to sysfs on page 23 Peripheral Component Interconnect PCI hot plug support Vital product data VPD support Storage Networking Industry Association Conformance Testing Program SNIA CTP compliant Storage Management Initiative specification SMI S 1 1 provid
33. Cannot issue Register Fabric login Err d Could not issue the fabric reg login the err value is unique for each possible failure Data None Severity Error Log LOG_ELS Action None required 0251 NameServer login no memory Could not allocate memory for the NDLP structure Data None Severity Error Log LOG_ELS Action None required 0252 Cannot issue NameServer login Could not issue an ELS PLOGI to the NameServer DID Data None Severity Error Log LOG_ELS Action Check the port connection and the switch configuration 0253 Register VPI Can t send mbox Could not issue the REG_LOGIN command for this VPort Data None Severity Error Log LOG_MBOX Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 4 Troubleshooting 61 Log Messages 0254 Register VPI no memory goto mbox err exit Could not allocate memory for the REG_LOGIN mailbox command Data None Severity Error Log LOG_MBOX Action None required 0255 Issue FDISC no IOCB All of the pre allocated IOCBs are in use Data None Severity Error Log LOG_ELS Action None required 0256 Issue FDISC Cannot send IOCB Unable to send the fabric IOCB Data None Severity Error Log LOG_ELS Action None required 0257 GID FT Query error The GID_FT CT request for the NameServer has fai
34. Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1012 Auth negotiate Bad Tag lt message gt DHCHAP Authentication process failed due to bad Tag for auto negotiation Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1013 Auth_negotiate no DH group found DHCHAP Authentication process failed when incorrect or missing DH Group was detected Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1014 dhchap challenge bad name tag lt message gt DHCHAP Authentication process failed when incorrect Challenge name tag was detected Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1015 dhchap challenge bad name length lt message gt DHCHAP Authentication process failed due to unexpected Challenge name length Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1016 dhchap challenge Hash ID not Supported lt message gt DHCHAP Authentication process failed due to uncorroborated Challenge Hash ID Data 1 message Severity Error
35. HBA Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 87 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0496 Failed allocate slow path EQ The event queue for the slow path was not allocated Data None Severity Error Log LOG_INIT Action Unload and reload the driver 0497 Failed allocate fast path EQ The event queue for the fast path was not allocated Data None Severity Error Log LOG_INIT Action Unload and reload the driver 0499 Failed allocate fast path FCP CQ lt fcp_cqidx gt The completion queue event for the fast path could not be allocated Data None Severity Error Log LOG_INIT Action Unload and reload the driver 0500 Failed allocate slow path mailbox CQ Failed to allocate slow path mailbox CQ Data None Severity Error Log LOG_INIT Action None required 0501 Failed allocate slow path ELS CQ Failed to allocate slow path ELS CQ Data None Severity Error Log LOG_INIT Action None required 0503 Failed allocate fast path FCP Failed to allocate fast path FCP Data None Severity Error Log LOG_INIT Action None required 0504 Failed allocate slow path ELS WQ Failed to allocate slow path ELS WQ Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Table 4 4 L
36. Log LOG_DISCOVERY LOG_MBOX Action None required 2552 UNREG FCFI issue mbox failed rc lt rc gt HBA state lt port_state gt The UNREG_FCFI mailbox command has failed Data None Severity Error Log LOG_DISCOVERY LOG_MBOX Action None required 2553 lpfc_unregister unused fcf failed to read FCF record HBA state Data None Severity Error Log LOG_DISCOVERY LOG_MBOX Action None required 2554 Could not allocate memory for fcf record Data None Severity Error Log LOG_MBOX LOG_SLI Action None required 2555 UNREG VFI mbxStatus error lt u mb mbxStatus gt HBA state lt port_state gt The UNREG_VFI mailbox command has failed Data None Severity Error Log LOG_DISCOVERY LOG_MBOX Action None required 2556 UNREG VFI mbox allocation failed HBA state lt port_state gt Could not allocate memory for UNREG_VFI mailbox command Data None Severity Error Log LOG_DISCOVERY LOG_MBOX Action None required 2557 UNREG VFI issue mbox failed rc lt rc gt HBA state lt port_state gt Could not issue the UNREG_VFI mailbox command Data None Severity Error Log LOG_DISCOVERY LOG_MBOX Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 124 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2558 ADD FCF RECORD mailbox failed with status lt shdr_st
37. Log onas root to a terminal and unpack the tarball tar xzf elx be2iscsi dd lt driver version gt tar gz 3 Change to the directory that is extracted cd elx be2iscsi dd lt driver version gt 4 Run the elx_iscsi_install sh script with no options to install the driver kit elx_iscsi_install sh 5 Once the elx_iscsi_install script has finished running successfully e For an iSCSI boot case you must reboot the system now to load the driver e For all other iSCSI cases the Emulex iSCSI driver is loaded and devices that are connected to the system are accessible Reboot the system now to enable the newly added driver options in the ramdisk You can also reboot the system later if you want Uninstalling the iSCSI Driver Kit Note You must run the uninstall script that shipped with the version of the driver kit you want to remove To uninstall the iSCSI driver 1 Log on as root Emulex Drivers for Linux User Manual P007633 01B Rev A 2 Installing and Uninstalling 17 DG EMULEX Booting from a Non Zero LUN Attached to an Emulex LPFC Adapter If possible exit all applications that use iSCSl attached drives then unmount the drives If you cannot exit all applications that use iSCSI attached drives the uninstall works properly but you must reboot after the uninstallation is complete sl Run the elx_iscsi_install sh script with the uninstall option elx iscsi _install sh uninstall Booti
38. N gt adaptive rx off rx usec 8 where eth lt N gt is the number of the Ethernet interface you are working on If your application requires low or predictive latency Emulex recommends that you turn off AIC and set rx usecs to 0 For transmit interrupts the default interrupt delay duration is 96 microseconds You can change this value using ethtool For example to set the TX interrupt delay to 64 microseconds run ethtool C eth lt N gt tx usec 64 where eth lt N gt is the number of the Ethernet interface you are working on Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 47 gt lt EMULEX Network Performance Tuning Receive Side Scaling RSS Distributing the incoming traffic across several receive rings with separate interrupt vectors helps to distribute the receive processing across several CPU cores This could reduce the packet drop and improve the packet rate in certain applications RSS is enabled in non SR IOV and non multichannel configurations In multichannel configurations RSS can be enabled in the first function of each port using the module parameter rss_on_mc See Table 3 3 Ethernet Driver Configuration Parameters on page 29 Analyzing Performance Issues MSI x interrupts are required for RSS to work If your motherboard and operating system version supports MSI X the OneConnect Ethernet driver automatically uses MSI X interrupts If there are not enough MSI X vectors available the Et
39. NIC to decide whether or not Redboot the primary redboot boot program should be flashed The driver skips updating this section This is a very unlikely error Could not set PCI DMA Mask The operating system call to set the DMA mask failed Error Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX 4 Troubleshooting 132 Table 4 5 Ethernet Driver Log Messages of Type Continued Log Messages Ethernet Log Message Description Type Emulex OneConnect 10Gbps_ Initialization of the UCNA or allocation of a resource Error NIC initialization failed for initializing the driver failed In most cases this message is accompanied by a more specific error message Try rebooting the system after power cycling If the issue persists this could be a symptom of a hardware issue or corrupted firmware Error in cmd completion A firmware command failed with the indicated status Error status compl extd code and extended status code lt DDD gt lt DDD gt Firmware lt filename gt load The firmware image under lib firmware lt filename gt Error error signature did not did not have the signature of a proper OneConnect match firmware image file The firmware in this file will not be flashed Copy the proper file and try flashing again Firmware flashed This is an informational message that the firmware on Information successfully the OneConnect UCNA has be
40. allocate the INIT_VPI mailbox command Data None Severity Error Log LOG_MBOX Action None required 2608 Failed to issue Init VPI mailbox The driver was unable to send an INIT_VPI mailbox command Data None Severity Error Log LOG_MBOX Action None required 2609 Init VPI mailbox failed lt u mb mbxStatus gt The INIT_VPI mailbox command failed Data None Severity Error Log LOG_MBOX Action None required 2610 UNREG FCFI mbox allocation failed Failed to allocate mailbox memory Data None Severity Error Log LOG_DISCOVERY LOG_MBOX Action None required 2611 UNREG FCFI issue mbox failed Could not issue the UNREG_FCFI mailbox command Data None Severity Error Log LOG_DISCOVERY LOG_MBOX Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 129 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2619 Config region 23 has bad signature Configuration region 23 has an invalid signature Data None Severity Error Log LOG_INIT Action None required 2620 Config region 23 has bad version Configuration region 23 has an invalid version Data None Severity Error Log LOG_INIT Action None required 2621 Failed to allocate mbox for query firmware config cmd Failed to allocate mailbox memory Data None Severity Error Log LOG_INIT Actio
41. daffy kernel lpfc 0000 03 06 0 0 1305 Link Down Event x2f2 received Data x2f2 x20 x110 In this example e lpfc 0000 03 06 0 identifies the identifies the PCI location of the particular LPFC hardware port e 0 indicates Emulex adapter 0 e 1305 indicates a log message number of 1305 Note If Data is present in a log message any information following Data is intended for Emulex technical support engineering use only LPFC Error Log Messages and their Descriptions Table 4 4 lists LPFC error log messages and their descriptions Table 4 4 LPFC Error Log Messages and their Descriptions 0111 Dropping received ELS cmd The driver decided to drop an ELS Response ring entry Data 1 ulpStatus 2 ulpWord 4 3 ulpTimeout Severity Error Log Always Action This error could indicate a software driver or firmware issue If this issue persists report these errors to Technical Support 0113 An FLOGI ELS command lt elsCmd gt was received from DID lt did gt in Loop Mode While in Loop Mode an unknown or unsupported ELS command was received Data None Severity Error Log Always Action Check device DID 0115 Unknown ELS command lt elsCmd gt received from NPORT lt did gt Received an unsupported ELS command from a remote N_Port Data None Severity Error Log Always Action Check the remote N_Port for a potential issue Emulex Drivers for Linux User Manual P007633 01B Rev A
42. entry The asynchronous event handler was unable to allocate an event queue entry to which to transfer the asynchronous event Data None Severity Error Log LOG_MBOX LOG_SLI Action This could be a V LINK clear from the switch or a fatal error from the firmware Perform a dump from the OneCommand Manager application Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 77 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0395 The mboxq allocation failed The asynchronous link event handler could not allocate a mailbox command to issue the READ_LA read link attention mailbox command Data None Severity Error Log LOG_SLI Action None required 0396 The lpfc_dmabuf allocation failed The asynchronous link event handler could not allocate a mailbox command to issue the READ_LA mailbox command Data None Severity Error Log LOG_SLI Action None required 0397 The mbuf allocation failed The asynchronous link event handler could not allocate DMA able memory for the READ_LA mailbox command Data None Severity Error Log LOG_SLI Action None required 0398 Invalid link fault code lt hex link fault gt The attempt to read the link attention register has returned an unknown value Data None Severity Error Log LOG_INIT Action None required 0399 Invalid link attention type lt hex link _type gt The REA
43. following e Ensure you are using the latest recommended firmware for VPort functionality Check the Emulex website for the latest firmware e Loop devices and NPIV are not supported on the same port simultaneously If you are running a loop topology and you create a VPort the VPort s link state is offline e You can create VPorts only on 4 8 10 and 16 Gb s adapters You cannot create VPorts on 1 and 2 Gb s adapters e VPorts do not persist across system reboots Creating Deleting and Displaying VPorts VPorts are created through sysfs entries that are presented in the physical port s sysfs directory The vport_create and vport_delete sysfs entries are discussed in VPort sysfs Entries on page 37 but there are also three scripts for creating deleting and displaying VPorts The scripts reside in the usr sbin Ipfc directory and are part of the OneCommand Manager application kit When NPIV is enabled and VPorts are configured it may take longer for the adapter to finish discovery in some cases because each VPort must perform discovery independently As more VPorts are configured the amount of time that the driver and adapter take to finish discovery of remote ports on the SAN increases To compensate for this extended amount of time taken in discovery set the lpfc_devloss_tmo parameter to 60 seconds when NPIV is enabled Creating VPorts Using the mkvport sh Script You can use the mkvport script to create VPorts To see the
44. gt limiting the FCP EQ count to lt cfg fcp_ wq count gt The fast path event queue cannot be greater than the fast path work queue count Data None Severity Warning Log LOG_INIT Action None required 2597 Mailbox command lt vpi gt lt mbxCommand gt cannot issue Synchronou 2 sli_flag 3 flag Data None Severity Error Log LOG_MBOX LOG_SLI Action None required 2598 Adapter Link is disabled The adapter link has been disabled Data None Severity Error Log LOG_INIT Action None required 2599 Adapter failed to issue DOWN LINK mbox command rc lt rc gt The driver was unable to issue the DOWN_LINK mailbox command Data None Severity Error Log LOG_INIT Action None required 2600 lpfc sli read serdes param failed to allocate mailbox memory Failed to allocate mailbox memory Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 4 Troubleshooting 128 Log Messages 2605 lpfc_dump_static_vport memory allocation failed Failed to allocate mailbox memory Data None Severity Error Log LOG_MBOX Action None required 2606 No NPIV Fabric support No NPIV Fabric support Data None Severity Error Log LOG_ELS Action None required 2607 Failed to allocate init _vpi mailbox Failed to
45. gt lt nlp _ flag gt The current node state does not have a handler for this event Data 1 nlp_rpi 2 nlp_flag Severity Error Log LOG_DISCOVERY Action Verify that all targets are still visible to the SCSI mid layer 0272 Illegal State Transition node lt nlp DID gt event lt evt gt state lt nlp state gt Data lt nlp rpi gt lt nlp_ flag gt The driver is completing a PLOGI but do not have the rcv_plogi flag set Data 1 nlp_rpi 2 nlp_flag Severity Error Log LOG_DISCOVERY Action Verify that all targets are still visible to the SCSI mid layer 0273 Unexpected discovery timeout vport State x x The discovery process has timed out Data None Severity Error Log LOG_DISCOVERY Action Verify that all targets are still visible 0274 lpfc_nlp put ndlp xtspusgmap x x refcnt d void ndlp ndlp gt nlp_usg_ map atomic_read amp ndlp gt kref refcount Data None Severity Warning Log LOG_NODE Action None required 0275 lpfc_nlp put ndlp xtspusgmap x x refcnt d void ndlp ndlp gt nlp_usg_ map atomic _read amp ndlp gt kref refcount A kref_put was called again after the node was already inactive Data None Severity Warning Log LOG_NODE Action None required 0276 lpfc_nlp get ndlp xspusgmap x x refcnt d void ndlp ndlp gt nlp_usg_map atomic _read amp ndlp gt kref refcount A kref_get was attempted on a node that was being released Data None Severit
46. gt is the IP address and port number and lt iface gt is the name of the iface created in step 1 Example iscsiadm m iface o new I iface0 iscsiadm m iface I ifaceO op update n iface hwaddress v 00 0F 1F 62 2B BF iscsiadm m iface I ifaceQ op update n iface transport_name v be2iscsi service open iscsi restart iscsiadm m discovery t st p 20 0 0 107 3260 I iface0 P 1 iscsiadm m iface I iface0 op update n iface hwaddress v 00 0F 1F 92 6B BF iscsiadm m iface I iface0 o update n iface ipaddress v 20 0 0 107 iscsiadm m node T iqn tgt0 p 20 0 0 107 3260 I iface0 1 fdisk 1 iscsiadm m node T iqn tgt0 p 20 0 0 107 3260 I iface0 u Emulex Drivers for Linux User Manual P007633 01B Rev A Appendix B Configuring iSCSI Through DHCP 138 IP Address Reservation gt G EMULEX Appendix B Configuring iSCSI Through DHCP IP Address Reservation If you are using the Dynamic Host Configuration Protocol DHCP server to obtain an IP address for your iSCSI initiator Emulex recommends that you set up a reservation A reservation assigns a specific IP address based on the MAC address of your iSCSI function If you do not reserve an IP address through DHCP you must set the lease length for the iSCSI initiator s IP address to unlimited This allows the IP address lease not to expire DHCP Option 43 Vendor Specific Information This section describes the format for the data returned in DHCP option
47. gt lt EMULEX Emulex Drivers for Linux User Manual P007633 01B Rev A Emulex Connects Servers Storage and People gt G EMULEX EMULEX CONFIDENTIAL Copyright 2012 Emulex All rights reserved worldwide Unpublished work No part of this document may be reproduced by any means or translated to any electronic medium without a the prior written consent of Emulex and b the preservation of this notice on all copies and partial copies Copying access use or distribution requires an applicable written agreement approved by Emulex Information furnished by Emulex is believed to be accurate and reliable However no responsibility is assumed by Emulex for its use or for any infringements of patents or other rights of third parties which may result from its use No license is granted by implication or otherwise under any patent copyright trade secret or related rights of Emulex Emulex the Emulex logo AutoPilot Installer AutoPilot Manager BlockGuard Connectivity Continuum Convergenomics Emulex Connect Emulex Secure EZPilot FibreSpy HBAnyware InSpeed LightPulse MultiPulse OneCommand OneConnect One Network One Company SBOD SLI and VEngine are trademarks of Emulex All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations Emulex provides this documentation as is without any warranty of any kind either expressed or implied including
48. gt posting all rpi headers The RPI headers could not be posted to the firmware Data None Severity Error Log LOG_SLI Action None required 2009 Failed to allocate mbox for ADD FCF cmd Failed to allocate mailbox for ADD_FCF command Data None Severity Error Log LOG_INIT Action None required 2010 Resume RPI Mailbox failed status lt status gt mbxStatus lt mbx status gt Data None Severity Error Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting DG EMULEX Log Messages 113 Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2011 Unable to allocate memory for issuing SLI_CONFIG_SPECIAL mailbox command Unable to allocate memory for issuing SLI_CONFIG_SPECIAL mailbox command Data None Severity Error Log LOG_SLI Action None required 2012 Mailbox failed mbxCmd lt mbx_cmd gt READ CONFIG mbxStatus lt mbx status gt The READ_CONFIG mailbox command failed Data None Severity Error Log LOG_SLI Action None required 2013 Could not manually add FCF record 0 status lt rc gt Could not add FCF record to the FCF list Data None Severity Error Log LOG_MBOX LOG_SLI Action None required 2014 Invalid command lt iocb ulpCommand gt The IOCB command is invalid Data None Severity Error Log LOG_SLI Action None required 2015 Invalid CT x command lt io
49. host 14 channel 0 id 0 lun 2 Vendor IBM Model ULTRIUM TD2 Rev 38D0 Type Sequential Access ANSI SCSI revision 03 Attached scsi tape st0 at scsil4 channel 0 id 0 lun 2 st0 try direct i o yes alignment 512 B max page reachable by HBA 4503599627370495 Attached scsi generic sg7 at scsil4 channel 0 id 0 lun 2 type 1 scsi scan INQUIRY to host 14 channel 0 id 0 lun 3 Vendor IBM Model ULTRIUM TD2 Rev 38D0 Type Sequential Access ANSI SCSI revision 03 Attached scsi tape stl at scsil4 channel 0 id 0 lun 3 stl try direct i o yes alignment 512 B max page reachable by HBA 4503599627370495 Attached scsi generic sg8 at scsil4 channel 0 id 0 lun 3 type 1 This log output shows a controller at LUN 0 the medium changer at LUN 1 and two SCSI tape devices at LUNs 2 and 3 The following example is the result of a scsi_id call scsi_id g s sys class scsi_tape nst0 Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 28 SXG EMULEX FC and FCoE Driver Configuration 1IBM ULTRIUM TD2 1110133831 scsi_id g s sys class scsi_tape nstl 1IBM ULTRIUM TD2 1110133994 Notice that the unique ID comprises three values with space delimiters A udev rule must have a unique ID for the device so that all three parts of this returned string are required To do this use the following command scsi_id u g s sys class scsi_tape nst0 1IBM ULTRIUM TD2 1110133831 scsi_id u g s sys class scs
50. iface created in step 1 4 Restart the service service open iscsi restart 5 Perform target discovery using SendTargets iscsiadm m discovery t st p lt ip port gt I ifaceO P 1 In this command lt ip port gt is the IP address and port number and lt iface gt is the name of the iface created in step 1 Emulex Drivers for Linux User Manual P007633 01B Rev A Appendix A Open iSCSI Support 137 gt EMULEX Connecting to the iSCSI Target 6 Add the iSCSI driver MAC address iscsiadm m iface I lt ifacename gt op update n iface hwaddress v lt iSCSI MAC Address gt In this command lt ifacename gt is the name of the iface created in step 1 and lt iSCSI MAC Address gt is the iSCSI MAC address 7 Set the initiator s IP address iscsiadm m iface I lt ifacename gt o update n iface ipaddress v lt IP gt In this command lt ifacename gt is the name of the iface created in step 1 and lt IP gt is the IP address 8 Log into the target iscsiadm m node T lt targetname gt p lt ip port gt I lt iface gt l In this command lt targetname gt is the target name you want to log into lt ip port gt is the IP address and port number and lt iface gt is the name of the iface created in step 1 9 Verify that the disk shows up fdisk 1 10 Log out iscsiadm m node T lt targetname gt p lt ip port gt I lt iface gt u In this command lt targetname gt is the target name lt ip port
51. in the driver is inactive Data 1 mb mbxCommand 2 sli_flag 3 flag Severity Error Log LOG_MBOX LOG_SLI Action None required 2531 Mailbox command lt cpi gt cannot issue Data 1 mb mbxCommand 2 sli_flag 3 flag Severity Error Log LOG_MBOX LOG_SLI Action None required 2532 Mailbox command lt vpi gt lt mbxCommand gt cannot issue The mailbox bootstrap code detected that the SLI layer is active Data 1 sli4_mbox_opcode 2 sli_flag 3 MBX_POLL Severity Error Log LOG_MBOX LOG_SLI Action None required 2533 Mailbox command lt vpi gt lt mbxCommand gt cannot issue Data 1 sli4_mbox_opcode 2 sli_flag 3 MBX_NOWAIT Severity Error Log LOG_MBOX LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 121 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2535 Unsupported RQ count lt entry count gt The receive queue ring can only be 512 1024 2048 or 4096 Data None Severity Error Log LOG_SLI Action None required 2536 Unsupported RQ count lt entry count gt The receive queue ring can only be 512 1024 2048 or 4096 Data None Severity Error Log LOG_SLI Action None required 2537 Receive Frame Truncated The receive unsolicited handler detected a truncated frame Data None Severity Error Log LOG_SLI Action None required
52. list of XRI SGEs failed to be registered with the firmware Data None Severity Error Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 125 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2566 Failed to allocate table entry Failed to allocate connection table entry Data None Severity Error Log LOG_INIT Action None required 2567 Config region 23 has bad signature The driver was unable to read Config Region 23 because it has an invalid signature Data None Severity Error Log LOG_INIT Action None required 2568 Config region 23 has bad version The driver was unable to read Config Region 23 because it is an invalid version Data None Severity Error Log LOG_INIT Action None required 2569 lpfc_ dump fcoe param memory allocation failed Memory allocation has failed Data None Severity Warning Log LOG_MBOX Action None required 2570 Failed to read FCoE parameters The driver failed to read FCoE parameters Data None Severity Error Log LOG_MBOX LOG_INIT Action None required 2572 Failed allocate memory for fast path per EQ handle array Failed to allocate memory for the fast path per EQ handle array Data None Severity Error Log LOG_INIT Action None required 2573 Failed allocate memory for msi x interrupt vector entri
53. lt vpi gt lt mbxCommand gt cannot issue The HBA cannot be accessed on the PCI bus Data 1 sli_mbox_opcode 2 sli_flag 3 flag Severity Error Log LOG_MBOX LOG_SLI Action None required 2546 New FCF found index lt index gt tag lt event_tag gt A new FCF has been found Data None Severity Error Log LOG_DISCOVERY Action None required 2547 Read FCF record failed Could not read the FCF record from the firmware Data None Severity Error Log LOG_DISCOVERY Action None required 2548 FCF Table full count lt count gt tag lt event_tag gt The FCF table is full Data None Severity Error Log LOG_SLI Action None required 2549 FCF disconnected from network index lt index gt tag lt event_tag gt The FCF has disconnected from the network Data None Severity Error Log LOG_DISCOVERY Action None required 2550 UNREG FCFI mbxStatus error lt u mb mbxStatus gt HBA state lt port_state gt The UNREG_FCFI mailbox command has failed Data None Severity Error Log LOG_DISCOVERY LOG_MBOX Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 123 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2551 UNREG FCFI mbox allocation failed HBA state lt port_state gt The allocation for the UNREG_FCFl mailbox command has failed Data None Severity Error
54. pci_dev_grp gt Invalid HBA PCI device group detected Data None Severity Error Log LOG_INIT Action None required 1425 Invalid PCI device group lt pci_dev_grp gt Invalid HBA PCI device group detected Data None Severity Error Log LOG_INIT Action None required 1426 Invalid PCI device group lt pci_dev_grp gt Invalid HBA PCl device group detected Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 109 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1427 Invalid PCI device group lt pci_dev_grp gt Invalid HBA PCI device group detected Data None Severity Error Log LOG_INIT Action None required 1428 Invalid PCI device group lt pci_dev_grp gt Invalid HBA PClI device group detected Data None Severity Error Log LOG_INIT Action None required 1429 Invalid PCI device group lt pci_dev_grp gt Invalid HBA PClI device group detected Data None Severity Error Log LOG_INIT Action None required 1430 Failed to initialize sql list Failed to initialize SQL list Data None Severity Error Log LOG_INIT Action None required 1431 Invalid HBA PCI device group lt pci_dev_grp gt Invalid HBA PCI device group detected Data None Severity Error Log LOG_INIT Action None required
55. reduce the amount of hardware resources for example RPIs that the driver requires In a configuration where there are many VPorts on one physical port this capability greatly reduces the number of RPIs that the driver uses ipfc_restrict_ login Read Write 0 Off 1 On default sys class scsi_host hostX lpfc_ restrict logi n VPorts only This entry sets the VPort s behavior when discovering targets in the SAN The default behavior value 1 prevents the VPort from logging into other initiator ports in the SAN It also rejects logins from other ports in the SAN because it assumes that all ports that send a PLOGI are initiators If this sysfs entry is turned off the driver attempts to log in to every port that it can access in the SAN and accepts logins from all ports Note This parameter was created to reduce the amount of hardware resources for example RPIs that the driver requires In a SAN where there are other initiators this capability greatly reduces the number of RPls that the driver uses max_npiv_vports Read only Emulex Drivers for Linux User Manual integers sys class fc_host hostX max_npiv_vports This entry displays the maximum number of VPorts that are supported by the fc_host s underlying hardware This sysfs entry exists only if the vport_create and vport_delete sysfs entries exist If an fc_host does not support NPIV this sysfs entry may not exist Use this sysfs
56. required 0543 lpfc_create static _vport failed to allocate vport_info n Failed to allocate vport_info Data None Severity Error Log LOG_INIT Action None required 0544 lpfc create static vport failed to issue dump mailbox command ret lt rc gt status lt mbxStatus gt Failed to issue a dump mailbox command for static VPort creation Data None Severity Warning Log LOG_INIT Action None required 0545 lpfc create static vport bad information header 0x x 0x x n le32 to _cpu vport_info gt signature le32 to _cpu vport_info gt rev amp VPORT_INFO_REV_MASK Invalid information header the signature or revision is invalid Data None Severity Error Log LOG_INIT Action None required 0546 lpfc create static vport failed to create vport Failed to create a VPort Data None Severity Warning Log LOG_INIT Action None required 0560 lpfc_ enable auth attribute cannot be set to lt val gt allowed range is 0 1 The lpfc_enable_auth attribute can only be 0 or 1 Data None Severity Error Log LOG_INIT Action None required 0582 Error lt rc gt during sgl post operation The SGL post operation failed Data None Severity Error Log LOG_MBOX LOG_IP verbose Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 941 SG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and the
57. their Descriptions Continued 1211 genreq alloc failed n Resource allocation failure Data 1 return code Log LOG_LIBDFC Severity Error Action Kernel memory resources too low 1213 FCoE cmd overflow off lt gt cnt lt gt gt cmdsz lt gt Application has tried to read more data than originally requested Data 1 response offset 2 size 3 cmd size Log LOG_LIBDFC Severity Error Action Application may have sent a invalid command 1214 Cannot issue FCoE cmd SLI not active lt gt rc EACCESS The SLI layer has not been initialized Data 1 offset Log LOG_LIBDFC Severity Error Action Restart the HBA 1215 Cannot issue FCoE cmd not ready or not in maint mode Either the external link is unplugged link down and the FCoE is not in maintenance mode Data 1 current offset 2 return code Log LOG_LIBDFC Severity Error Action Plug external cable in or set FCoE in maintenance mode 1216 FCoE IOCB failed off lt gt rc lt gt FCoE command generated by the application has failed Data 1 offset 2 return code Log LOG_LIBDFC Severity Error Action Application should retry the command 1223 menlo write couldn t alloc genreq Resource allocation failure Data None Log LOG_LIBDFC Severity Error Action Kernel memory resources too low 1224 FCoE iocb failed off lt gt rc lt gt FCoE command failed in SLI Data 1 offset
58. through this VPort or if there are open files on it Monitoring VPorts with fc_vport FC and FCoE Drivers For FC 8 2 0 x Drivers In the FC 8 2 0 x driver the fc_vport directory does not exist yet so a link from the physical port to the VPort is present in the fc_host s device directory ls sys class fc_host host5 device fc_host host5S power scsi _host hosts host6 uevent In this example host6 is a VPort of physical port host5 To find the VPorts that have been created by a physical port you can list the fc_host s device directory for the physical port This gives you a link to the fc_host and scsi_host directory as usual and it also displays a list of VPorts in the form of hostx that were created on this physical port For FC 8 3 5 x Drivers In the FC and FCoE 8 3 5 x driver the transport creates an fc_vports directory that you can use to monitor VPorts This directory is populated entirely of VPorts and has links from each to the fc_host associated with that VPort ls sys class fc_vports vport 5 0 0 ls d sys bus pci drivers lpfc host host sys bus pci drivers lpfc 0000 03 06 1 host5 vport 5 0 0 host6 ls sys devices pci host5 vport 5 host6 power rport 6 0 0 rport 6 0 1 rport 6 0 2 uevent ls sys devices pci host5 vport 5 host6 rport sys devices pci00 03 00 03 06 1 host5 vport 5 0 0 host6 rport 6 0 0 power uevent sys devices pci00 03 00 03 06 1 host5 vport 5 0 0 host6 rpo
59. usage information run the script with no parameters specified The mkvport sh script uses the following syntax mkvport sh lt Physical Port s Host number gt lt Port Name gt lt Node Name gt You must supply the physical port s host number WWPN and WWNN when using the mkvport sh script For example to create a VPort with port name of 10000000c94ac63a and a node name of 20010000c94ac63a on the physical port with scsi_host name host7 type mkvport sh host7 10000000c94ac63a 20010000c94ac63a This script fails if the VPort is not created Note It is possible for a VPort to be created successfully but to be in failed state For example loop devices and NPIV are not supported on the same port simultaneously If you are running a loop topology and you create a VPort the VPort s link state will be offline Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 35 gt EMULEX Virtual Port VPort Configuration Deleting VPorts Using the rmvport sh Script Note You must un map un mount and flush I Os to VPort connected devices before deleting the VPort You can use the rmvport script to delete VPorts To see the usage information run the script with no parameters specified The rmvport sh script uses the following syntax remvport sh lt VPort s Host number gt 0r rmvport sh lt Port Name gt lt Node Name gt To delete the VPort with a port name of 10000000c94ac63a and a node name of
60. 0200 CONFIG LINK bad hba state lt hba_state gt A CONFIG_LINK mailbox command completed and the driver was not in the right state Data None Severity Error Log Always Action Software driver error If this issue persists report these errors to Technical Support 0203 Devloss timeout on WWPN lt address gt NPort lt nlp_ DID gt A remote N_Port that was discovered by the driver disappeared for more than lpfc_devloss_tmo seconds Data 1 nlp_flag 2 nlp_state 3 nlp_rpi Severity Error Log Always Action If the device generating this message is not a target to which the HBA is connected this error will not affect the data integrity of the 1 0 between the HBA and the attached storage and can be ignored Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 58 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0206 Device discovery completion error This indicates that an uncorrectable error was encountered during device re discovery after a link up FC devices will not be accessible if this message is displayed Data None Severity Error Log Always Action Reboot the system If this issue persists report the error to Technical Support Run with verbose mode enabled for more information 0207 Device lt DID gt lt WWN gt sent invalid service parameters Ignoring device Invalid service parameters were received from DID Ignoring thi
61. 1 hbainit Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0443 Adapter failed to set maximum DMA length mbxStatus lt u mb mbxStatus gt Cannot set the maximum DMA length to reflect cfg_pci_max_read Data None Severity Error Log LOG_INIT Action Set module parameter lpfc_pci_max_read to 512 1024 2048 or 4096 0446 Adapter failed to init mbxCmd lt mbxCommand gt CFG RING mbxStatus lt mbxStatus gt ring lt num gt Adapter initialization failed when issuing a CFG_RING mailbox command Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0447 Adapter failed init mbxCmd lt mbxCommand gt CONFIG LINK mbxStatus lt mbxStatus gt Adapter initialization failed when issuing a CONFIG_LINK mailbox command Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0448 Adapter failed to init mbxCmd lt mbxCommand gt READ SPARM mbxStatus lt mbxStatus gt Adapter initialization failed when issuing a READ_SPARM mailbox command Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the err
62. 1432 Failed to initialize rpi headers Failed to initialize RPI headers Data None Severity Error Log LOG_INIT Action None required 1476 Failed to allocate sysfs attr Failed to allocate sysfs attributes Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 110 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1477 Failed to set up hba Failed to set up the HBA Data None Severity Error Log LOG_INIT Action None required 1603 Loopback test did not receiv xpected data length actual length lt len gt expected length lt full_size gt The loopback test did not receive the same amount of data that it transmitted Data None Severity Error Log LOG_LIBDFC Action None required 1800 Could not issue unreg vpi Driver attempt to unregister VPI failed Data None Severity Error Log LOG_VPORT verbose Action Software driver error If this issue persists report these errors to Technical Support 1801 Create vport work array FAILED cannot do scsi_host_get The driver was unable to get a reference to a SCSI host Data None Severity Warning Log LOG_VPORT verbose Action Software driver warning If this issue persists report these errors to Technical Support 1816 FLOGI NPIV supported response data lt port gt The
63. 20010000c94ac63a type rmvport sh 10000000c94ac63a 20010000c94ac63a This script may take up to 30 seconds to finish The script fails if the VPort is not deleted Displaying VPorts Using the Isvport sh Script You can use the Isvport script to display the VPorts and physical ports that are present on the system Run the script with no parameters to display port information For example lsvport sh lpfc0O host6 10000000c93a5b5e 20000000c93a5b5e LP10000 NPIV Not Supported lpfcl host7 10000000c93a5b5d 20000000c93a5b5d LP10000 NPIV Not Supported lpfc2 host8 10000000c93cc8dd 20000000c93cc8dd LPe12000 NPIV Physical lpfc3 host9 10000000c93cc8dc 20000000c93cc8dce LPel2000 NPIV Physical lpfc4 host10 10000000c94ac63a 20010000c94ac63a NPIV Virtual VPI 1 In reference to the previous example e For LPFCO and LPFC1 NPIV Not Supported means that this adapter firmware combination does not support the creation of VPorts e For LPFC2 and LPFC3 NPIV Physical refers to a physical port of this adapter e For LPFC4 NPIV Virtual refers to a VPort of this adapter VPort sysfs VPort sysfs Tree For FC 8 2 0 x Drivers When a VPort is created two new directories are created in the class tree sys class scsi_host hostyY sys class fc_host hostyY Creating a new VPort also creates a new sysfs directory in the bus and devices tree ls sys bus pci drivers lpfc 0000 07 00 0 host8 Emulex Drivers for Linux User Man
64. 4 VPorts to be created but the driver has only been qualified at 64 For mid range adapters the maximum number of VPorts configurable on a physical port is 16 The maximum number of LUNs supported on each driver port is 256 The maximum number of targets supported for each driver port is 255 The maximum number of driver ports in one zone is 64 This limit is based on the system s ability to recover from link events within the time constraints of the default timers The NPIV use cases that involve virtual server environment include associating a VPort with a virtual machine and placing the virtual machine in its own zone This results in one VPort per zone In the case of load balanced environments this can increase typically to two VPorts per virtual machine to a practical limit of something far less than 50 In the NPIV cases not related to virtual server environments zoning is typically initiator zoning again resulting in one VPort or a low number of VPorts in the case of load balancing within a given zone If there are too many VPorts within a single zone expected behavior includes devices being lost after link events The minimum lifetime of a VPort is 60 seconds There is an unenforced limit of 60 seconds between the creation of a VPort and the deletion of the same VPort VPorts are designed to live for a long time in the system and the creation of VPorts is asynchronous This means that a VPort might not be finished with FC o
65. 43 The method and format for specifying the Vendor ID is outside the scope of this document and is not included here The initiator offers this Vendor ID to the DHCP server to retrieve data in the format as described in DHCP Option 43 Format on page 139 DHCP Option 43 Parameter Descriptions Table B 1 describes the parameters used in the format data string for option 43 Table B 1 DHCP Option 43 Vendor Specific Information Parameter lt TargetIP gt Description Replace with a valid IPv4 address in dotted decimal notation Field Type Mandatory lt TargetTCPPort gt Replace with a decimal number ranging from 1 to 65535 inclusive The default TCP port 3260 is assumed if a value is not specified Optional lt LUN gt A hexadecimal representation of the Logical Unit Number of the boot device Replace with an eight byte number that should be specified as a hexadecimal number consisting of 16 digits with an appropriate number of zeros padded to the left if required If a value is not provided LUN 0 is assumed to be the boot LUN Optional lt TargetName gt Replace with a valid target iSCSI Qualified Name IQN name of up to 223 characters Mandatory lt InitiatorName gt Replace with a valid initiator IQN of up to 223 characters If a value is not provided the default initiator name generated by the OneConnect UCNA based on the board s MAC address is used Optional
66. C attached disks Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 26 gt EMULEX FC and FCoE Driver Configuration To use a persistent name for a boot device with SLES 10 SPx and SLES 11 SPx 1 In boot grub menu lst find the kernel line for the default boot For example kernel boot vmlinuz root dev sda2 vga 0x314 2 Find the persistent name for the root partition following root on the kernel line by using the instructions in Using udev to Discover Logical to Physical Mappings for sd Devices on page 25 3 Inthe same file boot grub menu lst replace the text after root with the partition s persistent name For example kernel boot vmlinuz root dev disk by id scsi 32000000c5005d6e6 part2 vga 0x314 4 Change any mounts listed in etc fstab that refer to this root partition by either its dev sd name or a file system label to use the persistent name as well For RHEL 5 x and RHEL 6 x To use a persistent name for a boot device with RHEL 5 x and RHEL 6 x 1 In boot grub grub conf find the kernel line for the default boot For example kernel boot vmlinuz lt kernel version gt ro root dev sda2 2 Find the persistent name for the root partition following root on the kernel line by using the instructions in Using udev to Discover Logical to Physical Mappings for sd Devices on page 25 3 Inthe same file boot grub menu lst replace the text after root w
67. CP Segmentation Offload TSO In low loss networks TSO considerably improves performance and therefore must be enabled TSO is enabled by default in OneConnect network driver The proc sys net ipv4 tcp_tso_win_divisor proc variable controls the aggressive the network stack can be in making TSO requests For low less networks Emulex Emulex Drivers for Linux User Manual P007633 01B Rev A 3 Configuration 44 Network Performance Tuning gt G EMULEX recommends TSO divisor values in the range of 2 to 16 In most distributions the default value of 3 seems to be the optimal choice for a no loss network Smaller divisor values result in larger TSO chunks and better throughput as well as better CPU utilization However if the receiver or the network is dropping frames too many retransmits on the transmit side as indicated by netstat st it may help to make TSO chunks smaller by increasing the divisor value or to turn TSO off For example to set the divisor level to a value of 8 run echo 8 gt proc sys net ipv4 tcp_tso win divisor To turn TSO on or off run one of the following ethtool commands ethtool K eth lt N gt tso on ethtool K eth lt N gt tso off where eth lt N gt is the name of the Ethernet device you are working on for example eth0 Flow Control The OneConnect UCNA supports IEEE 802 3x standard flow control which uses control packets to temporarily pause the transmission of packets between two endpoints
68. D_LA mailbox command has returned an invalid link type Data None Severity Error Log LOG_INIT Action None required 0400 lpfc_nodev_tmo attribute cannot be set to lt val gt allowed range is lt LPFC MIN DEVLOSS TMO gt lt LPFC MAX DEVLOSS TMO gt The attempt to set the devloss timeout value failed because the value is out of the allowable range Data None Severity Error Log LOG_INIT Action Use a value between the minimum and maximum values 0401 Ignoring change to nodev_tmo because devloss_ tmo is set Attempting to change the nodev timeout when the devloss has already been set Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 78 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0402 Cannot find virtual addr for buffer tag on ring lt ringno gt A DMA buffer is unavailable for this unsolicited command Data 1 tag 2 next 3 prev 4 postbufq_cnt Severity Error Log LOG_INIT Action None required 0403 lpfc_nodev_tmo attribute cannot be set to lt val gt allowed range is lt LPFC_ MIN DEVLOSS TMO gt lt LPFC MAX DEVLOSS TMO gt Attempt to set the nodev timeout value is outside the range of the devloss timeout range Data None Severity Error Log LOG_INIT Action Set the nodev timeout between the minimum and maximum timeout
69. ENT Action Try resetting the FCoE to operational mode and disable maintenance mode 1247 FCoE chip is running diagnostic firmware Operational use suspended lt fw_type gt The FCoE is running a diagnostic DATA 1 firmware type Severity Error Log LOG_LINK_EVENT Action Try resetting the FCoE to operational mode 1248 FCoE chip is running unknown firmware lt fw_type gt The FCoE is running an unknown firmware version Data 1 firmware type Severity Error Log LOG_LINK_EVENT Action Try resetting the FCoE to operational mode Try loading latest FCoE firmware 1249 Invalid FRU data found on adapter Return adapter to Emulex for repair The FRU data on the FCoE chip is invalid Data 1 firmware type Severity Error Log LOG_LINK_EVENT Action Try resetting the FCoE to operational mode Try loading latest FCoE firmware or send the HBA back to Emulex for repair Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 103 SG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1250 Menlo command error code lt gt The IOCB driver sent to check FCoE state has bad header size Data 1 return code Log LOG_LINK_EVENT Severity Error Action Try resetting the FCoE to operational mode 1251 Menlo command error code lt gt The IOCB driver sent to check FCoE state has failed no resources Data 1 return code Log LOG_
70. Gb s GRO GRUB GUI HBA INTx IOCB IOPs IOV IP IQN iSCSI ISNS KB LACP LDTO LPFC LUN MBR MPIO MSI MSI X MSS MTU NAA NIC 1 Introduction 11 Abbreviations driver update disc driver update package extended link service extended timeout Fibre Channel Fibre Channel Security Protocol Fibre Channel Arbitrated Loop Fibre Channel over Ethernet Fibre Channel Protocol front side bus GNU Compiler Collection gigabits per second Generic Receive Offload Grand Unified Bootloader graphical user interface host bus adapter PCle legacy interrupts where x is variable input output control block I O operations per second I O virtualization Internet Protocol iSCSI Qualified Name internet Small Computer System Interface internet storage name service Kilobyte 1024 bytes Link Aggregation Control Protocol link down timeout LightPulse Fibre Channel logical unit number master boot record multipath I O message signaled interrupts message signaled interrupts extended maximum segment size parameter for TCP maximum transmission unit network address authority network interface card or controller Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX NPIV OL PCI PCIe PF PID PLOGI POST RHEL RPI RPM RSCN RSS SAN SCSI SLES SLI SMI S SMP SNIA CTP SNMP SR IOV TCP VPD WWPN Emulex Drivers for Linux User Manual 1 Introduction 12 Abbreviations
71. LINK_EVENT Severity Error Action Try resetting the FCoE to operational mode 1252 Menlo command error code lt gt The IOCB driver sent to check FCoE state has failed Data 1 return code Log LOG_LINK_EVENT Severity Error Action Try resetting the FCoE to operational mode 1257 lpfc_menlo_issue_iocb handler set for lt context3 gt Data None Log LOG_LIBDFC Severity Warning Action None required 1259 mbox Issued mailbox cmd lt u mb mbxCommand gt while in stopped state Only the dump mailbox command and reset adapter mailbox command are allowed when in the stopped state Data None Severity Warning Log LOG_MBOX Action None required 1262 Failed to allocate dfc_host Could not allocate memory the dfc_host_struct Data None Log LOG_LIBDFC Severity Error Action None required 1268 Find ndlp returned NULL for oxid x x SID x x oxid sid int off rc Could not find the node for this DID Data None Severity Warning Log LOG_ELS Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 104 SG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1302 Invalid speed for this board Reset link speed to auto lt cfg link speed gt The driver is re initializing the link speed to auto detect Data None Severity Warning Log LOG_LINK_EVENT verbose Action None required 1303 Lin
72. Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 96 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1017 dhchap challenge could not find DH Group DHCHAP Authentication process failed due to uncorroborated Challenge Group Data None Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1018 dhchap challenge No Public key for non NULL DH Group There is no Public key for the non NULL DH Group Data None Severity Error Log LOG_SECURITY Action None required 1019 Request tranid lt tran_id gt timed out A transaction with storage array could not complete due to timeout Data 1 tran_id Severity Warning Log LOG_SECURITY verbose Action Software driver warning If this issue persists report these errors to Technical Support 1021 ERROR attempted to queue security work when no workqueue created Driver encountered missing queue required for processing security information Data None Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report these errors to Technical Support 1022 Security request does not exist A security request operation failed because there was no match found for such requ
73. MULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0313 Ring lt ringno gt handler unexpected Rctl lt Rctl gt Type lt Type gt received The RCTL Type of a received frame did not match any for the configured masks for the specified ring Data None Severity Warning Log LOG_SLI verbose Action This error could indicate a software driver firmware or hardware issue Report these errors to Technical Support 0303 Ring lt ringno gt handler portRspPut lt portRspPut gt is bigger then rsp ring lt portRspMax gt The port rsp ring put index is larger than the size of the rsp ring Data None Severity Error Log Always Action This error could indicate a software driver firmware or hardware issue Report these errors to Technical Support 0304 Stray mailbox interrupt mbxCommand lt mbxcommand gt mbxStatus lt mbxstatus gt Received a mailbox completion interrupt and there are no outstanding mailbox commands Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0306 CONFIG LINK mbxStatus error lt mbxStatus gt HBA state lt hba_state gt The driver issued a CONFIG_LINK mailbox command to the HBA that failed Data None Severity Error Log Always Action This error could indicate a firmware or hardware issue Report these errors to Technical S
74. PFC Error Log Messages and their Descriptions Continued 4 Troubleshooting 88 Log Messages 0505 Failed allocate slow path ELS MQ Data None Severity Error Log LOG_INIT Action None required 0506 Failed allocate receive HRQ n Data None Severity Error Log LOG_INIT Action None required 0507 Failed allocate receive DRQ Failed to allocate receive DRQ Data None Severity Error Log LOG_INIT Action None required 0520 Slow path EQ not allocated The slow path EQ not allocated Data None Severity Error Log LOG_INIT Action None required 0522 Fast path EQ lt fcp eqidx gt not allocated The fast path EQ is not allocated Data None Severity Error Log LOG_INIT Action None required 0523 Failed setup of fast path EQ lt fcp_eqidx gt rc lt rc gt The fast path EQ setup failed Data None Severity Error Log LOG_INIT Action None required 0526 Fast path FCP CQ lt fcp_cqidx gt not allocated The fast path FCP is not allocated Data None Severity Error Log LOG_INIT Action None required 0527 Failed setup of fast path FCP CQ lt fcp_cqidx gt rc lt rc gt The fast path FCP CQ setup failed Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 4 Troubleshoot
75. T Action None required 1403 Failed to set up driver resource Driver resource initialization failed Data None Severity Error Log LOG_INIT Action None required 1404 Failed to set up driver resource Driver resource initialization failed Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 106 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1405 Failed to initialize iocb list Driver resource initialization failed Data None Severity Error Log LOG_INIT Action None required 1406 Failed to set up driver resource Initialization failed to set up driver resource Data None Severity Error Log LOG_INIT Action None required 1407 Failed to create scsi host Initialization failed to create SCSI host Data None Severity Error Log LOG_INIT Action None required 1408 Failure HBA POST Status sta_reg 0x x perr x x sfi x x nip x x ipc x x xrom x x dl x x pstatus x x n sta_reg word0 bt get lpfc_hst_state perr amp sta_reg The HBA s power on self test has failed Data None Severity Error Log LOG_INIT Action None required 1409 Failed to enable pci devic Failed to enable PCI device during initialization Data None Severity Error Log LOG_INIT Action None required
76. TO value is reached and the initiator is still unable to connect to the target the driver fails all I O requests At this point I O errors are seen by the application and operating system Note Following a link up switch ports can take a long time to initialize and go to the forwarding state Because of this additional time should be added to the ETO and LDTO settings to eliminate I O disruption or target unavailability If the switch port is connected to a single host then the PortFast mode can be enabled on the switch port to eliminate delays when transitioning to the forwarding state Error Handling Under MultiPath I O MPIO and Cluster Configurations In an MPIO or cluster configuration fault tolerant software is present on the system that makes the iSCSI driver error handling redundant These configurations also require that I O errors be reported as soon as they are detected so that the software can fail over to an alternate path or an alternative node as quickly as possible When the iSCSI driver runs under these configurations the error handling implemented in the driver must be turned off by setting the default values of LDTO and ETO to zero The changes take effect during the next driver load Emulex Drivers for Linux User Manual P007633 01B Rev A 3 Configuration SG EMULEX Virtual Port VPort Configuration 34 Virtual Port VPort Configuration VPort Configuration Prerequisites Before configuring VPorts note the
77. Table 3 6 Table 4 1 Table 4 2 Table 4 3 Table 4 4 Table 4 5 Table 4 6 Table B 1 Table C 1 Emulex Drivers for Linux User Manual Static FC and FCoE Driver Parameters wii ccvscssdavecescesevsssstavevsiacdesesesacces 18 Dynamic FC and FCoE Driver Parameters cccccseccceeesscceceesscceeeesaees 21 Ethernet Driver Configuration Parameters ssssssessssesssssesesseesseseee 29 iSCSI Driver Configuration ParaMmeterS ccscccceecescccccsscsceeeessccseeeees 30 Interrupt Moderation Policy im_policy Settings cece eeeeeee ee eeeeees 32 VPort sysfs EMUri S csc ccsecteevsvescaeees et E etern ETNE eceties dies SE TEE iE 37 FC and FCoE Driver Situations and their Resolutions cc cece sence eee eees 48 Ethernet Driver Situations and their ReESOLUtIONS cee ceeee eee eee eee eeees 52 iSCSI Driver Situations and their Resolutions cee cecee ee eec eee eneeeeeeees 53 LPFC Error Log Messages and their Descriptions ce ceeeece ee eee eee eeeeee 54 Ethernet Driver Log Messages Of Type cccccccccceeeeeeccsceeeeeeeeeeeeeeees 131 iSCSI Driver Error Log Messages e cece ee ecee cece eee eeennnceeeeeeeeeeeeeees 134 DHCP Option 43 Vendor Specific Information ceeeeeeeeeeeeeeeeeees 138 OneConnect 10 GbE UCNA Negotiated Speed Specifications 141 P007633 01B Rev A List of Tables 8 gt G EMULEX Overview 1 Introdu
78. The mailbox command sent to create the event queue has failed Data None Severity Error Log LOG_INIT Action None required 2501 CQ CREATE mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to create the completion queue has failed Data None Severity Error Log LOG_INIT Action None required 2502 MQ CREATE mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to create the mailbox queue has failed Data None Severity Error Log LOG_INIT Action None required 2503 WWQ CREATE mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to create the work queue has failed Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 117 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2504 RQ CREATE mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to create the receive queue has failed Data None Severity Error Log LOG_INIT Action None required 2505 EQ DESTROY mailbox failed with statu
79. When enabled engage the devloss timeout for initiators The enabled value is 1 The disabled value is 0 default Note This parameter is applicable to FC 8 2 0 x drivers only Yes lpfc_discovery_threads Specifies the maximum number of ELS commands that can be outstanding for a discovery Note The lpfc_discovery_threads parameter defaults to a value of 64 for private loop topologies regardless of the configured value If there are multiple ports configured on the host the value of 64 is only used for those ports that are connected in a private loop topology The configured value is used for all other ports The minimum value is 1 The maximum value is 64 The default value is 32 No lpfc_enable_da_id When enabled the FC and FCoE driver issues a DA_ID CT command to the fabric when VPorts log out of the fabric The enabled value is 1 The disabled value is 0 default No lpfc_enable_hba_ heartbeat Emulex Drivers for Linux User Manual When enabled the heartbeat logic in the FC and FCoE driver is able to detect whether the adapter is functional If the heartbeat logic detects the adapter is not functional the driver will shut down the adapter The enabled value is 1 default The disabled value is 0 Yes P007633 01B Rev A gt G EMULEX 3 Configuration FC and FCoE Driver Configuration Table 3 1 Static FC and FCoE Driver Parameters Continued sysfs Para
80. _fcp_class rw r r 1 root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_fdmi_on r r r 1 root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_ link speed Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 24 SXG EMULEX FC and FCoE Driver Configuration rw r r root root 4096 Feb 28 15 34 sys class scsi_host host7 lpfc_log_verbose SEASESsr root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_lun_queue_depth rw r r root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_max_luns rw r r root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_nodev_tmo rw r r root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_scan_down r r r root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_topology rw r r root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_use_adisc Temporary Configuring Parameters with sysfs In the previous example notice that the FC and FCoE driver parameters are available as files Reading a file displays the current value of a driver parameter If the permissions allow it you can write a value to the file and it will take effect immediately Reading the lpfc_log_verbose file may show that its value is 0 cat sys class scsi_host host7 lpfc_log_ verbose 0 To modify the lpfc_log_verbose value to Oxffffffff echo Oxffffffff gt sys class scsi_host host7 lpfc_ log verbose Reading the lpfc_log_verbos
81. a None Severity Error Log LOG_INIT Action Unload and reload the driver 0433 Wakeup on signal rc lt rc gt A signal other than the LPFC_DATA_READY was received on the worker thread Data None Severity Error Log LOG_ELS Action Unload and reload the driver 0434 PM resume failed to start worker thread error lt error gt The driver s power management resume function could not start the worker thread Data None Severity Error Log LOG_INIT Action Unload and reload the driver Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 841 SG EMULEX Log Messages Emulex Drivers for Linux User Manual Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0435 Adapter failed to get Option ROM version status lt rc gt The driver could not read the HBA s option ROM Data None Severity Error Log LOG_INIT Action Reset the HBA Ensure the adapter s firmware is current 0436 Adapter failed to init timeout status reg lt status gt The adapter failed during power up diagnostics after it was reset Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0437 Adapter failed to init chipset status reg lt status gt The adapter failed during power up diagnostics after it was reset Data None Severity Error Log Always
82. alue Data None Severity Error Log LOG_INIT Action Set the module parameter between the minimum and maximum values 0425 lpfc_ restrict login attribute cannot be set to d allowed range is 0 1 The module parameter lpfc_restrict_login can only be set to 0 off or 1 on Data None Severity Error Log LOG_INIT Action Set lpfc_restrict_login 0 1 Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 4 Troubleshooting 80 Log Messages 0426 Failed to enable interrupt The driver failed to start the interrupt Data None Severity Error Log LOG_INIT Action Unload and reload the driver 0427 Cannot re enable interrupt after slot reset The driver was unable to enable the interrupt after an HBA reset Data None Severity Error Log LOG_INIT Action Unload and reload the driver 0429 MSI X fast path request irq failed lt rc gt The driver received an error for the request_irq_call Data None Severity Warning Log LOG_INIT Action Unload and reload the driver 0430 PM resume Failed to enable interrupt The driver s power management resume function could not enable the interrupt Data None Severity Error Log LOG_INIT Action Perform another PM suspend and resume or HBA reset 0431 Failed to enable interrupt The driver failed to start the interrupt Dat
83. ameter settings are not compatible Resolve the parameter conflict by setting the SLI mode to 0 or 3 or if SLI 2 mode is required then disable NPIV Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 112 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1825 Vport Created This message is displayed to indicate that a port was created in the system It is displayed at this level to ensure it is always appears at all log levels Data None Severity Error Log LOG_VPORT verbose Action No action informational 1826 Vport Disabled The port had to be disabled in the system Data None Severity Error Log LOG_VPORT verbose Action No action informational 1827 Vport Enabled The port had to be enabled after possible recovery from some errors Data None Severity Error Log LOG_VPORT verbose Action No action informational 1828 Vport Deleted A Vport was deleted Data None Severity Error Log LOG_VPORT verbose Action No action informational 1829 CT command failed to delete objects on fabric A command issued to the fabric to delete an associated resource for an object such as for a port failed Data None Severity Error Log LOG_VPORT verbose Action Software driver error If this issue persists report these errors to Technical Support 1830 Signal aborted mbxCmd lt command gt A pe
84. and their Descriptions When reporting an issue with the OneConnect UCNA check the kernel message log using the dmesg command or the var log messages file and report any of these entries that may be present There are three types of Ethernet log messages error information and warning Ethernet driver warning messages logged by a OneConnect UCNA start with be2net lt BID gt where lt BID gt is the PCI bus identifier string For example be2net 0000 0d 00 1 MTU must be between 256 and 9000 bytes Note In the following table lt D gt lt DD gt or lt DDD gt refers to decimal values that appear in the log messages Table 4 5 Ethernet Driver Log Messages of Type Ethernet Log Message Description Type lt D gt pending tx completions The driver did not get completions for some transmit Error requests from the NIC while unloading the driver This is usually indicates an issue with the NIC cmd to write to flash rom The firmware command to install the latest firmware Error failed type op lt D gt lt D gt version on the OneConnect UCNA failed with the indicated error code Could not create sysfs The creation of the flash_fw entry under the Error group sys class net eth lt x gt failed The driver is fully functional but you cannot install later firmware versions on the OneConnect UCNA Could not get cre from The driver could not get enough information from the Error flash not flashing
85. aptive Interrupt Coalescing AIC or can be set to a constant value Setting the Interrupt Delay Duration to a Range of Values AIC For receive interrupts AIC is enabled by default When AIC is enabled the default low limit is 0 microseconds and the default high limit is 96 microseconds In low traffic the interrupt delay is set to 0 for best latency As the number of interrupts per second increases the delay is increased to higher values proportional to the receive rate up to the default high limit of 96 microseconds You can change the low and high limits using ethtool For example to set a low limit of 8 and a high limit of 40 run ethtool C eth lt N gt rx usecs low 8 ethtool C eth lt N gt rx usecs high 40 where eth lt N gt is the name of the Ethernet device you are working on for example eth0 For transmit interrupts AIC is not supported To disable AIC and set the interrupt delay duration to a constant value see the following section Setting the Interrupt Delay Duration to a Constant Value The interrupt delay duration can be set to a constant value for both receive and transmit interrupts The possible interrupt delay duration values are 0 to 96 microseconds in 8 microsecond increments For receive interrupts disable AIC since it is enabled by default and set the interrupt delay duration using ethtool For example to disable AIC and set the constant RX interrupt delay to 8 microseconds run ethtool C eth lt
86. ata 1 reason 2 explanation Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 98 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1039 Not Expecting Reply rejecting State lt state gt An unanticipated reply was received during authentication and was subsequently rejected Data 1 auth_state Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1040 Bad Reply trans_id rejecting Trans_id lt trans_id gt Expecting lt trans_id gt Unexpected transaction id was received during authentication and was subsequently rejected Data 1 auth_state Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1043 Authentication LS_RJT The authentication request was rejected Data None Severity Error Log LOG_ELS Action None required 1045 Issue AUTH NEG failed Status x The authentication negotiation failed Data None Severity Error Log LOG_ELS Action None required 1048 Issue AUTH REJECT failed Could not issue the reject for the authentication request Data None Severity Error Log LOG_ELS Action None required
87. ata None Severity Error Log LOG_SLI Action None required 0367 Fast path completion queue does not exist The fast path completion queue referenced by the CQID does not exist Data None Severity Error Log LOG_SLI Action None required 0368 Mis matched fast path completion queue identifier eqcqid d fcpcqid d The CQID in the event queue entry does not match the fcp_cqid that was passed into the routine Data None Severity Error Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 74 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0369 No entry from fast path completion queue fcpcqid lt queue_id gt There were no completions in the completion queue referenced by fcp_cqid Data None Severity Error Log LOG_SLI Action None required 0370 Invalid completion queue type lt type gt The event queue entry is not for a mailbox or a work queue entry Data None Severity Error Log LOG_SLI Action None required 0371 No entry from the CQ identifier lt queue_id gt type lt type gt There was no completion queue event for this event queue entry Data None Severity Error Log LOG_SLI Action None required 0372 iotag lt iotag gt is out of range max iotag lt sli last_iotag gt The IOCB lookup cannot be performed because the iocb_tag is out
88. ation Unloading the FC and FCoE driver on SLES 10 SPx or SLES 11 SPx may cause a message to be logged in the system log such as the following umount dev disk bypath pci 0000 02 04 0 scsi 0 0 1 0 not mounted Resolution These messages are normal output from the SLES 10 SPx and SLES 11 SPx hotplug scripts and can be safely ignored Driver installation fails The lpfc install script fails to install the driver The install script may fail for the following reasons e A previous version of the driver is installed Run the pfc install uninstall script and then try to install the driver e The current driver is already installed e Runa supported RHEL or SLES kernel No module lpfc found for kernel KERNELVERSION RPM error message when upgrading the kernel A recently upgraded kernel cannot find the ramdisk After upgrading the kernel the kernel cannot find the ramdisk which halts or panics the system The driver is not loaded after a system reboot after upgrading the kernel These three situations can be resolved by upgrading the kernel There are two ways to install the driver into an upgraded kernel The method you use depends on whether you are updating the driver e Upgrade the kernel using the same version of the driver e Upgrade the kernel using a new version of the driver See chapter 2 Installing and Uninstalling on page 13 for these procedures Driver uninstallation fa
89. atus gt add_status lt shdr_add_status gt The ADD_FCF_RECORD mailbox command has failed Data None Severity Error Log LOG_INIT Action None required 2559 Block sgl registration required DMA size lt reqlen gt great than a page Attempting to register more SGEs with the firmware than can fit in a page Data None Severity Warning Log LOG_INIT Action None required 2560 Failed to allocate mbox cmd memory n Failed to allocate mailbox command memory Data None Severity Error Log LOG_INIT Action None required 2561 Allocated DMA memory size lt alloclen gt is less than the requested DMA memory size lt reqlen gt Could not get the memory required for the number of XRIs that are attempting to be posted Data None Severity Error Log LOG_INIT Action None required 2562 No room left for SCSI XRI allocation max xri lt sli4 hba max cfg param max_xri gt els xri lt els xri_cnt gt n The number of allocated XRIs has reached the max_xri value Data None Severity Error Log LOG_SLI Action None required 2563 Failed to allocate memory for SCSI XRI management array of size lt sli4 hba scsi_ xri_max gt Initialization could not allocate memory to hold the XRIs Data None Severity Error Log LOG_SLI Action None required 2564 POST SGL BLOCK mailbox command failed status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The
90. c login vport_create Write only Emulex Drivers for Linux User Manual WWPN WWNN sys class fc_host hostX vport_create This entry creates a VPort on the physical port that hostX is located on The new VPort will have a WWPN and WWNN present on the fabric based on the WWPN and WWNN that are entered with this sysfs entry This entry returns a O if the VPort creation was successful A non zero value indicates that the VPort was not created If an fc_host does not support NPIV then this sysfs entry may not exist Note It is possible for the VPort creation to succeed but for the VPort to be in a failed or inoperative state Use the new sysfs tree created by the new VPort to check the state of the new VPort P007633 01B Rev A is 3 Configuration 39 gt EMULEX Virtual Port VPort Configuration Table 3 6 VPort sysfs Entries Continued VPort sysfs Range Entries Type Input Location and Description vport_delete Write WWPN WWNN sys class fc_host hostX vport delete only This entry deletes a VPort on the physical port that hostX is located on The VPort matching the WWPN and WWNN is immediately deleted This entry returns a O if the VPort deletion was successful A non zero value indicates that the VPort was not deleted If an fc_host does not support NPIV then this sysfs entry may not exist Note This entry deletes the VPort even if there are mounted file systems being accessed
91. c should have been MBX_BUSY The completion handler for REG_LOGIN detected the IMMED_UNREG flag and tried to issue the UNREG_LOGIN command from an interrupt level The mailbox status should still be busy Data None Severity Error Log LOG_MBOX LOG_SLI Action None required 0386 ELS complete with no corresponding cmdiocb iotag lt iotag gt The completion that the ISR is handling cannot find a tag associated with the IOTAG Data None Severity Warning Log LOG_SLI Action None required 0387 Failed to allocate an iocbq Failed to get an IOCBQ from the list of available IOCBQs Data None Severity Error Log LOG_SLI Action None required 0388 Not a valid WCQE code x lt hex cqe_code gt The event code is invalid This event will be dropped Data None Severity Error Log LOG_SLI Action Ensure the adapter s firmware is current 0391 Error during rpi post operation The driver was trying to post pages to the firmware to be used to keep target login information and encountered a failure Data None Severity Error Log LOG_MBOX LOG_SLI Action Unload and reload the driver 0393 Error lt rc gt during rpi post operation The driver was trying to post pages to the firmware to keep target login information and encountered a failure Data None Severity Error Log LOG_MBOX LOG_SLI Action Unload and reload the driver 0394 Failed to allocate CQ EVENT
92. cb ulpCommand gt Invalid Command Type in the IOCB is not supported Data None Severity Error Log LOG_SLI Action None required 2017 REG FCFI mbxStatus error lt mbx status gt HBA state lt port_state gt The REG_FCFI mailbox command has failed Data None Severity Error Log LOG_MBOX Action None required 2018 REG VFI mbxStatus error lt mbx status gt HBA state lt port_state gt The REG_VFI mailbox command has failed Data None Severity Error Log LOG_MBOX Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 116 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2020 Failed to allocate mbox for ADD FCF cmd Failed to allocate mailbox for ADD_FCF command Data None Severity Error Log LOG_INIT Action None required 2022 VPI Mailbox failed status lt status gt mbxStatus lt mbxStatus gt The INIT VPI mailbox command has failed Data None Severity Error Log LOG_SLI Action None required 2401 Failed to allocate memory for ELS XRI management array of size lt els_ xri_cnt gt Initialization failed to allocate memory for the ELS XRI management array Data None Severity Error Log LOG_SLI Action None required 2500 EQ CREATE mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt
93. ccccscccceecssccccessccceeeessccceessseceees 42 Enabling Optimal Bandwidth Options c ccc ece eee cece e scene eee eeeeeeseeeeeeeeeenees 42 Populate DIMM SlOUS s scicseiveevsscewdwadedeviciccndena dente vausensedndessecwaesdeensteewesameenvie seni 42 Disabling Memory Mirroring cece cece cece ee ee eee e eee e tees eeseeeeeeeeeeseeeeeeaeeneeees 43 Using a Fast Clock Speed for the Front Side Bus FSB sceeeceeeeeeee eset eeeeeees 43 Network Memory LIMICS cccnecacnesecvedssautesianssuntesaensateeiseveinantaudadansaaeenideionse 43 TCP Segmentation Offload TSO sessssseescosssscsssssosssecccsscesosssecosesecsssesoo 43 Emulex Drivers for Linux User Manual P007633 01B Rev A D6 EMULEX Table of Contents 7 Flow Controliccrisiiirirnerivinii tian an EA AEA R EE EERE RECRE R 44 RX Frame Coalescing seerisoirice rines stins innesa Giiacvetaarsaavarenseebiveseniwiaausseaeuvaues 45 Maximum Transmission Unit MTU esssssssssssssssssssssssssssssesssesssesessssesseessee 45 Interrupt COBLESCING ssecrsssirircirissiviruswisrsti tecvit rik Ncr i tss Kurte Vitr t i new iek naiki 46 Setting the Interrupt Delay Duration to a Range of Values AIC ce see eeee eee ees 46 Setting the Interrupt Delay Duration to a Constant Value sce e eee eee eee e eee eeee 46 Receive Side Scaling RSS ssesesssesssssscsesesecossesosesececssecsosesseesesscesseeoo 47 Analyzing Performance ISSUGS
94. ction 1 Introduction Overview This Emulex Drivers for Linux User Manual provides installing updating uninstalling configuring and troubleshooting procedures for several types of Emulex supported drivers for Linux This manual is applicable to several versions of Linux drivers operating systems firmware and adapters For a list of supported Emulex drivers for Linux and their associated compatible operations systems see Supported Driver Versions on page 3 For supported firmware versions and their latest release see the Downloads page on the Emulex website for the specific adapter For a list of Emulex adapters that are compatible with the standalone driver kits see the Downloads page on the Emulex website for the specific driver The Emulex drivers for Linux include Emulex Drivers for Linux User Manual P007633 01B Rev A Support for LightPulse Fibre Channel LPFC family of adapters Support for OneConnect family of Universal Converged Network Adapters UCNAs including 10 GbE UCNAs and OCe11102 xT 10GBASE T UCNAs Supported protocols o FC initiator mode and FCoE o SCSI FCP o FCP 2 FC Tape profile including use of ADISC instead of PLOGI o Ethernet supported Linux kernel is SLES 11 SPx supported kernel variants for x86 and x86_64 o iSCSI supported Linux kernel is SLES 11 SPx supported kernel variants for x86 and x86_64 Supported FC topologies point to point FC Arbitrated Loop FC
95. d array Data None Severity Error Log LOG_INIT Action None required 2579 Slow path wqe consume event carries miss matched qid weqe qid lt wcge quid gt sp qid lt sp_ quid gt The consumed entry does not have the slow path s queuelD Data None Severity Warning Log LOG_SLI Action None required 2580 Fast path wqe consume event carries miss matched qid weqe qid lt fcp wqid gt The consumed entry does not have the fast path s queuelD Data None Severity Warning Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 127 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2581 Not enough WQs lt sli4 hba max_cfg param max_wq gt from the pci function for supporting FCP WQs lt cfg_ fcp_wq count gt The driver was not configured with the minimum number of fast path work queues Data None Severity Error Log LOG_INIT Action None required 2582 Not enough WQs lt max_wq gt from the pci function for supporting the requested FCP WQs lt cfg wq count gt the actual FCP WQs can be supported lt wq_count gt The driver was not configured with enough fast path work queues Data None Severity Warning Log LOG_INIT Action None required 2593 The FCP EQ count lt cfg fcp_eq_count gt cannot be greater than the FCP WQ count lt cfg_fcp_ wq count
96. d performs better than a system with a slower FSB clock speed Network Memory Limits The default values of tunable parameters in the Linux network stack are optimal for most network applications involving several TCP UDP streams The optimal size for the network queues and buffers depend on several factors such as protocol number of streams connections request size and application behavior The following network configuration settings are a good combination to get the best uni directional transmit and receive performance with six or more TCP connections UDP streams echo 4096 87380 4194304 gt proc sys net ipv4 tcp_rmem echo 4096 16384 4194304 gt proc sys net ipv4 tcp_wmem echo 64000000 gt proc sys net core rmem_ default echo 64000000 gt proc sys net core rmem_max echo 32000000 gt proc sys net core wmem_ default echo 32000000 gt proc sys net core wmem_ max These settings assume ideal conditions such as low latency zero or close to zero packet loss in the network enough free memory and 10 Gb s path to peer system These tcp_rmem and tcp_wmem values are also the default values in recent RHEL 5 and SLES 10 distributions If your application requires best throughput with very small number of connections less than four it may help to increase the tcp_rmem and tcp_wmem to much larger values echo 4096 87380 16777216 gt proc sys net ipv4 tcp_rmem echo 4096 65536 16777216 gt proc sys net ipv4 tcp_wmem T
97. data in a single I O request When large_io is set to 512 then up to 512 KB of data can be supported in a single I O request The minimum value is 128 default The maximum and only other value is 512 For more information see Configuring the large_io Parameter on page 31 LDTO The Link Down Timeout LDTO parameter determines the amount of time in seconds that the initiator driver waits for the controller s physical link to become available before reporting that the LUNs are unavailable to the operating system The minimum value is 0 The maximum value is 3600 The default value is 20 For more information see Configuring the ETO and LDTO Parameters on page 31 and Error Handling using ETO and LDTO Parameters on page 33 im_policy The Interrupt Moderation policy im_policy parameter specifies the rate of interrupts for OneConnect UCNAs The possible values are e 0 disables the interrupt algorithm highest interrupt rate moderate interrupt rate default an interrupt rate between moderate and lowest lowest interrupt rate AUN For more information see Configuring the im_policy Parameter on page 32 Emulex Drivers for Linux User Manual P007633 01B Rev A 3 Configuration gt EMULEX iSCSI Driver Configuration 31 Configuring the iSCSI Driver Parameters Configuring the ETO and LDTO Parameters ETO and LDTO values are configurable during insmod time The ETO value specified duri
98. e Virtual Fabric Index for the FCFI Data None Severity Error Log LOG_ELS Action Check the switch and port configurations 0290 The SLI4 DCBX asynchronous event is not handled yet The SLI 4 DCBX asynchronous event is not handled yet Data None Severity Error Log LOG_SLI Action None required 0291 Allocated DMA memory size x x is less than the requested DMA memory size x x The asynchronous DCBX events are not handled in the driver Data None Severity Error Log LOG_INIT Action Check the switch configuration 0293 PM resume failed to start worker thread error lt error gt The PCI resume hotplug could not start the worker thread for the driver Data None Severity Error Log LOG_INIT Action Unload and reload the driver Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 66 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0294 PM resume Failed to enable interrupt The PCI resume hotplug could not get an interrupt vector Data None Severity Error Log LOG_INIT Action Unload and reload the driver 0297 Invalid device group lt pci_dev_grp gt While unloading the driver the driver detect a PCI device that it should not have claimed Data None Severity Error Log LOG_INIT Action None required 0299 Invalid SLI revision lt sli_rev gt While processing a host attention
99. e file now shows a value of Oxffff cat sys class scsi_host host7 lpfc_log_ verbose Oxffffffft Creating a New Ramdisk Image The Ipfc install script creates a ramdisk image containing the FC and FCoE driver for the currently running kernel Note You must create a new ramdisk image whenever the LPFC options in etc modprobe conf are changed and you want the change to take effect on the next reboot To create a new initial ramdisk image for inbox FC and FCoE drivers and installed binary RPM FC driver kits e For SLES 10 PPC64 architecture distributions type mkinitrd k vmlinux i initrd e For SLES 10 non PPC64 architecture distributions and SLES11 SPx distributions type mkinitrd k vmlinuz i initrd e For RHEL 5 x distributions type mkinitrd f boot initrd lt kernel version gt img lt kernel version gt Emulex Drivers for Linux User Manual P007633 01B Rev A 3 Configuration 25 SXG EMULEX FC and FCoE Driver Configuration e For RHEL 6 x distributions type dracut f boot initramfs lt kernel version gt img lt kernel version gt Dynamically Recognizing LUNs and Targets using scan The FC and FCoE driver enables you to dynamically recognize LUNs and targets without unloading or reloading the LPFC module and without resetting the adapter To rescan an adapter s targets with sysfs given the adapter s host number in this example 3 type echo gt sys class scsi_host host3 scan To limit the resca
100. e group lt dev_grp gt Invalid HBA PCI device group detected Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting DG EMULEX Log Messages 108 Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1420 Invalid HBA PCI device group lt dev_grp gt Invalid HBA PCl device group detected Data None Severity Error Log LOG_INIT Action None required 1421 Failed to set up hba Initialization failed to set up the HBA Data None Severity Error Log LOG_INIT Action None required 1422 HBA Unrecoverable error uerr_lo reg lt ue lo gt uerr_hi_reg lt ue hi gt onlineO reg lt OnlineO0 gt onlinel reg lt Onlinel gt The HBA has notified the driver that it has encountered an unrecoverable error Data None Severity Error Log LOG_INIT Action A dump from the OneCommand Manager application should be taken Then the driver should be unloaded and reloaded 1423 HBA Unrecoverable error uerr_lo_reg lt ue lo gt uerr hi_reg lt ue hi gt onlineO reg lt OnlineO gt onlinel reg lt Onlinel gt The HBA has notified the driver that it has encountered an unrecoverable error Data None Severity Error Log LOG_INIT Action A dump from the OneCommand Manager application should be taken Then the driver should be unloaded and reloaded 1424 Invalid PCI device group lt
101. e of default TCP port and mutual CHAP settings iscsi 192 168 0 2 000000000000000E iqn 2009 4 com 1234567890 aadi E n wp uM In this example the field values are TargetIP 192 168 0 2 TargetT CPPort Use default from RFC 3720 3260 LUN 0x0E TargetName iqn 2009 04 com 1234567890 InitiatorName Not specified Use the Initiator name already configured Use the default name if none was configured HeaderDigest Enabled DataDigest Disabled AuthenticationType Mutual CHAP is enabled Emulex Drivers for Linux User Manual P007633 01B Rev A e Appendix C OneConnect 10 GbE UCNA Port Speed Specifications 141 gt EMULEX Port Speed Negotiation on Non Mezzanine Cards Appendix C OneConnect 10 GbE UCNA Port Speed Specifications Port Speed Negotiation on Non Mezzanine Cards OneConnect 10 GbE UCNAs can support only one Ethernet port speed at a time On non mezzanine cards its preference is 10 Gb s The type of module used copper optical does not make a difference If a 10 Gb s module is plugged into one of the ports the UCNA runs at a 10 Gb s speed regardless of its other port s speed even if I Os are running on that port This behavior is an adapter constraint another adapter can be running on a different speed Table C 1 lists negotiated speed specifications per OneConnect 10 GbE UCNA port connection Table C 1 OneConnect 10 GbE UCNA Negotiated Speed Specifications
102. en updated Firmware load error Updating the OneConnect UCNA with new firmware Error failed Usually this message is accompanied by a detailed messages on the failure Flash cookie not found in The firmware image under lib firmware lt filename gt Error firmware image does not have the expected cookie The firmware in this file will not be flashed Copy the proper file and try flashing again Flashing firmware file This is an informational message that the firmware in Information lt filename gt the OneConnect UCNA is being updated with the firmware image in the file indicated INTx Request IRQ failed The request for INTx interrupt registration failed The Error err lt DDD gt driver is non functional if the INTx interrupt cannot be registered Invalid mailbox completion The driver received an unexpected completion status Error for a firmware command Link down Link up This is an informational message about a change in Link Information status mbox db poll timed out A firmware command did not complete in a reasonable Error time This is most likely due to a firmware or hardware issue Try rebooting the system Memory allocation failure The driver could not allocate memory required for Error while flashing flashing the firmware image Try flashing later If this issue persists try flashing after a system reboot Module param rx _frag_size An unsupported receive buffer size was passed for the Warning must be 2048 4096 8192 r
103. entry with npiv_vports_inuse to determine whether the maximum number of VPorts have been created on this fc_host P007633 01B Rev A gt G EMULEX Table 3 6 VPort sysfs Entries Continued 3 Configuration 38 Virtual Port VPort Configuration VPort sysfs Entries node_name Type Read only Range nput 16 byte hexadecimal value Location and Description For FC 8 2 0 x drivers sys class fc_host hostX node_name For FC 8 3 5 x drivers sys class fc_host hostX node_name sys class fc_vports vport X 0 Z node_name These entries display the physical or VPort s node name You assign this value when the VPort is created and it is transmitted to the fabric upon fabric login npiv_vports_inuse Read only integers sys class fc_host hostX npiv_vports inuse This entry displays the number of VPorts that were created on this fc_host This sysfs entry exists only if the vport_create and vport_delete sysfs entries exist If an fc_host does not support NPIV this sysfs entry may not exist Use this sysfs entry with max_npiv_vports to determine whether the maximum number of VPorts have been created on this fc_host port_name Read only 16 byte hexadecimal value sys class fc_host hostX port_name sys class fc_vports vport X 0 Z port_name This entry displays the physical or VPort s port name You assign this value when the VPort is created and it is transmitted to the fabric upon fabri
104. er Linux Tools hyperlink provided in the Linux portion on the Emulex website http www emulex com files downloads linux tools html Supports N_Port ID virtualization NPIV virtual ports NPIV is supported on Emulex Service Level Interface 4 SLI 4 OCe10102 series UCNAs NPIV is also supported on SLI 3 4 8 and 16 Gb s adapters Emulex enterprise class 5 digit adapter model number and midrange class 4 digit adapter model number adapters support SLI 3 For SLI 4 and SLI 3 supported adapters use the latest recommended firmware for NPIV support The FC 8 2 0 x and 8 3 5 x drivers support adapters running SLI 2 but NPIV support is unavailable in SLI 2 mode Known Issues Known issues are defined in the Emulex Drivers for Linux Release Notes which are available on the driver s Downloads page on the Emulex website Also some known issues are detailed in chapter 4 Troubleshooting on page 48 Abbreviations ADISC Discover Address AIC adaptive interrupt coalescing AMD Advanced Micro Devices API application programming interface BIOS basic input output system CentOS Community Enterprise Operating System BIOS basic input output system CLI command line interface DHCHAP Diffie Hellman Challenge Handshake Authentication Protocol DIMM dual in line memory module DMA direct memory access Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX DUD DUP ELS ETO FC FC SP FC AL FCoE FCP FSB GCC
105. er changelog file Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 2 Installing and Uninstalling 14 gt lt EMULEX Ethernet Driver Kit Installing the Binary RPM FC and FCoE Driver Kit Note You must uninstall any FC driver kits that are not part of this distribution For example you must uninstall any previous FC and FCoE driver kits that were installed from the Emulex website before installing this driver kit This installation fails if a previous version of the FC and FCoE driver kit is detected For more information see Uninstalling the Binary RPM FC and FCoE Driver Kit on page 14 To install the binary RPM FC and FCoE driver 1 2 Download the appropriate driver kit from the Emulex website Log on as root to a terminal and unpack the tarball tar xzf elx lpfc dd lt Linux distribution version gt lt driver version gt tar gz Change to the directory that is extracted cd elx lpfc dd lt Linux distribution version gt lt driver version gt Run the elx_lpfc_install sh script without options to install the driver kit elx_lpfc_install sh Once the elx_lpfc_install sh script has finished running successfully the Emulex FC and FCoE driver is loaded and devices that are connected to the system are accessible Reboot the system to enable the newly added driver options in the ramdisk You can also reboot the system later if you want Uninstalling the Binary RPM FC and FCoE Drive
106. es The driver was unable to allocate memory during initialization of the MSI X interrupt array Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 126 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2574 Not enough EQs lt sli4 hba max cfg param max_eq gt from the pci function for supporting FCP EQs lt cfg_ fcp_eq count gt Failed to create the minimum fast path event queues Data None Severity Error Log LOG_INIT Action None required 2575 Not enough EQs lt max_eq gt from the pci function for supporting the requested FCP EQs lt cfg fcp_ eq count gt the actual FCP EQs can be supported lt eq_count gt The driver was not configured with enough fast path event queues Data None Severity Warning Log LOG_INIT Action None required 2576 Failed allocate memory for fast path EQ record array Failed to allocate memory for the fast path EQ record array Data None Severity Error Log LOG_INIT Action None required 2577 Failed allocate memory for fast path CQ record array Failed to allocate memory for the fast path EQ record array Data None Severity Error Log LOG_INIT Action None required 2578 Failed allocate memory for fast path WQ record array Failed to allocate memory for the fast path EQ recor
107. essages Retrieving iSCSI Driver Error Log Messages For Linux systems the iSCSI driver generates log messages to the var log messages file The log file is an ASCII text file and can be viewed and searched with your preferred text editor To search the log file for error messages at the command prompt type cd var log vim messages For example you may see the following message be2iscsi driver detected error 0x12790006 iSCSI Driver Error Log Messages and their Descriptions All iSCSI driver error log messages are preceded by a prefix of scsiX if the SCSI host controller can be determined with X being a number representing the Linux SCSI host controller and OneConnect iSCSI Driver for example scsi2 OneConnect iSCSI Driver buffer siz limit exceeded Rejected IOCTL sinc scsi2 OneConnect iSCSI Driver Subsystem Opcode 0x12345678 0x11223344 scsi2 OneConnect iSCSI Driver Payload Length 0x1000 Note Some error log entries may be followed by additional entries that provide further information Note In the following table OxX refers to a hexadecimal value that appears in the log messages Table 4 6 lists iSCSI driver error log messages and their descriptions Table 4 6 iSCSI Driver Error Log Messages iSCSI Error Log Message Description Did not receive an iSCSI Command _ Check for any errors reported at the target The Emulex window update from Target for at
108. est Data None Severity Warning Log LOG_SECURITY Action Software driver warning If this issue persists report these errors to Technical Support 1023 Warning data may have been truncated Data lt data gt reqdl lt data_len gt mesd1l lt data_len gt A security message exchange operation failed because the response was missing or unreliable Data None Severity Warning Log LOG_SECURITY Action Software driver warning If this issue persists report these errors to Technical Support 1028 Start Authentication No buffers The authentication failed because some memory resources were not allocated Data None Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 97 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1029 Reauthentication Failure The driver encountered errors and there was a failure to re authenticate Data None Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1031 Start Authentication Get config failed The authentication failed due to some error during port configuration Data None Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Tec
109. et d d The SCSI layer issued a target reset Data None Severity Error Log LOG_FCP Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 93 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0724 I O flush failure for context lt LUN TGT HOST Unknown gt cnt lt cnt gt The 1 0 flush to the LUN target or host has failed Data None Severity Error Log LOG_FCP Action None required 0727 TMF lt cmd gt to TGT lt TGT gt LUN lt LUN gt failed lt ulpStatus gt lt ulpWord 4 gt The task management command failed Data None Severity Error Log LOG_FCP Action None required 0729 FCP cmd lt cmnd gt failed lt target gt lt lun gt status lt status gt result lt result gt The specified device failed an FCP command Data 1 ulpContext 2 iotag Severity Warning Log LOG_FCP verbose Action Check the state of the target in question 0730 FCP command failed RSP The FCP command failed with a response error Data 1 resp_info 2 scsi_status 3 Resid 4 SnsLen 5 RspLen 6 rspInfo3 Severity Warning Log LOG_FCP verbose Action Check the state of the target in question 0734 FCP read check error The issued FCP command returned a read check error Data 1 fcpDl 2 rspResld 3 fcpi_parm 4 cmd 0 Severity Warning Log LOG_FCP verbose Action Check t
110. fabric reports support for NPIV upon FLOGI Data 1 response_multiple_NPort Severity Warning Log LOG_VPORT verbose Action No action needed informational 1817 Fabric does not support NPIV configuring single port mode The fabric reports no support for NPIV upon FLOGI Data None Severity Warning Log LOG_VPORT verbose Action No action needed informational 1818 VPort failed init mbxCmd lt mailbox command gt READ SPARM mbxStatus lt mailbox status gt re lt status gt A pending mailbox command that was issued to initialize the port failed Data 1 mbxCommand 2 mbxStatus 3 rc Severity Error Log LOG_VPORT verbose Action Software driver error If this issue persists report these errors to Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 111 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1819 Unrecognized lpfc_sli_ mode parameter lt mode gt The user has attempted to set the SLI mode to an invalid value The valid values for the SLI mode are 0 2 and 3 Data 1 lpfc_sli_mode Severity Error Log LOG_VPORT verbose Action The lpfc_sli_mode driver parameter setting must be corrected Valid values are 0 2 and 3 1820 Unable to select SLI 3 Not supported by adapter The HBA is incapable of operating in a given mode Data None Severity Error Log LOG_VPORT verbose
111. fication configured for loopback Data 1 fc_eventTag 2 port_state 3 vport fc_flag Severity Error Log LOG_LINK_EVENT Action None required 1309 Link Up Event npiv not supported in loop topology NPIV is not supported in loop topology Data None Severity Error Log LOG_LINK_EVENT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 4 Troubleshooting 105 Log Messages 1310 Menlo Maint Mode Link up Event lt eventTag gt rcvd The link is up in maintenance mode only management commands are allowed Data 1 fc_eventTag 2 port_state 3 vport fc_flag Severity Error Log LOG_LINK_EVENT Action None required 1312 Link Down Event lt eventTag gt received Maintenance mode link up notification received without entering link down Data 1 fc_eventTag 2 port_state 3 vport fc_flag Severity Error Log LOG_LINK_EVENT Action None required 1400 Failed to initialize sgl list Failed to initialize SGL list during initialization Data None Severity Error Log LOG_INIT Action None required 1401 Failed to enable pci devic Failed to enable PCI device during initialization Data None Severity Error Log LOG_INIT Action None required 1402 Failed to set up pci memory space PCI initialization failed Data None Severity Error Log LOG_INI
112. ftware driver Error If this issue persists report errors to the Technical Support 1007 Bad Name length in auth message lt message gt DHCHAP Authentication process failed when invalid name was detected Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1008 Bad Number of Protocols lt message gt DHCHAP Authentication process failed due to unexpected protocol number Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1009 Bad param type lt message gt DHCHAP Authentication process failed when invalid protocol was detected Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting Q5 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1010 Bad Tag 1 lt message gt DHCHAP Authentication process failed when bad Tag was detected Data 1 message Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1011 Auth_neg no hash function chosen DHCHAP Authentication process failed when an incorrect hash function was specified
113. g 0x x A mailbox command failed to complete The driver is resetting the port Data None Severity Error Log LOG_MBOX LOG_SLI Action If the mailbox command fails again set the lpfc_log_verbose to LOG_MBOX and retry 0346 Ring lt ring number gt handler unexpected ASYNC_STATUS evt_code lt evt code gt WO lt hex w0 gt W1 lt hex wl gt W2 lt hex W2 gt W3 lt hex W3 gt W4 lt hex W4 gt W5 lt hex W5 gt W6 lt hex W6 gt W7 lt hex W7 gt W8 lt hex W8 gt W9 lt hex W9 gt W10 lt hex W10 gt Wll lt hex W11 gt The HBA received an asynchronous event that was not a temperature event Data None Severity Error Log LOG_SLI Action None required 0347 Adapter is very hot please take corrective action Adapter temperature is above normal range Data Temperature in Celsius Severity Error Log LOG_TEMP verbose Action Shutdown and remove the HBA Contact Technical Support 0348 NameServer login node freed The enable mode failed to free up the NameServer login Data None Severity Error Log LOG_ELSI Action None required 0349 rc should be MBX SUCCESS The next mailbox command on the mailbox queue has failed Data None Severity Error Log LOG_MBOX LOG_SLI Action None required 0350 rc should have been MBX BUSY Attempting to unregister a default RPI from an interrupt context and the mailbox state is not busy Data None Severity Error Log LOG_MBOX LOG_SLI
114. go to http www emulex com files downloads linux tools html Under certain conditions of an I O load some targets cannot retire an 1 0 issued by a Linux initiator within the default timeout of 30 seconds given by the SCSI mid level If the situation is not corrected the initiator to target condition deteriorates into abort recovery storms leading to I O failures in the block layer These types of failures are preceded by a SCSI 1 0 error of hex 6000000 Emulex provides a script that addresses this issue To access the set_target_timeout sh script go to http www emulex com files downloads linux tools html The FC or FCoE driver fails to recognize an adapter and logs unknown IOCB messages in the system log during driver load The adapter is running outdated firmware Install the latest firmware on the adapter Loading the FC and FCoE driver on SLES 10 SPx and SLES 11 SPx reports unsupported module tainting kernel in system log This message is logged by the kernel whenever a module that is not shipped with the kernel is loaded This message can be ignored The system panics when it is booted with a failed adapter installed Emulex Drivers for Linux User Manual Remove the failed adapter and reboot the system P007633 01B Rev A gt G EMULEX 4 Troubleshooting 50 Situations and their Resolutions Table 4 1 FC and FCoE Driver Situations and their Resolutions Continued Situ
115. he state of the target in question 0735 FCP Read Check Error and Underrun Data HBA reported under run from storage array Data 1 vpi 2 fcpDI 3 res_id 4 fcpi_parm Severity Warning Log LOG_FCP_ERROR verbose Action No action needed informational 0748 Abort handler timed out waiting for abort to complete ret lt status gt D lt target id gt LUN lt lun id gt The abort handler timed out waiting for abort to complete Data None Severity Error Log Always Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 94 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0749 SCSI layer issued abort device The SCSI layer aborted a device Data 1 ret 2 id 3 lun 4 snum Severity Warning Log LOG_FCP verbose Action None required 0915 Register VPI failed lt mbxStatus gt Could not register the VPI Data None Severity Error Log LOG_MBOX Action None required 1005 AUTHENTICATION FAILURE Nport lt port gt The system detected DHCHAP authentication failure on a port Data 1 nlp_DID Severity Error Log LOG_SECURITY Action Verify authentication settings and keys on local and remote port 1006 Bad Name tag in auth message lt message gt DHCHAP Authentication process failed when invalid tag was detected Data 1 message Severity Error Log LOG_SECURITY Action So
116. hernet driver uses INTx interrupts which may decrease performance The proc node proc interrupts shows the interrupts and their types The Linux performance utility top can monitor the CPU utilization while trouble shooting performance issues A low idle CPU percentage in any CPU core is an indication of excessive processing load for that CPU The proc node proc interrupts shows the distribution of the interrupts across the CPU cores If you see too many interrupts per second directed to one CPU check if the irqbalance program is running The irqbalance program is normally started at system boot In some cases you can get better performance by disabling irqbalance and manually distributing interrupts You can manually distribute the interrupt load across the available CPU cores by setting the CPU affinity for any interrupt vector by setting the mask in the proc node proc irg lt int vector gt smp_affinity Use the netstat command to look for excessive TCP retransmits or packet drops in the network stack Use the S option of ethtool to see all statistics counters maintained by the OneConnect Ethernet and driver Excessive drop or error counters are an indication of a bad link or defective hardware Turning off auditing and SELinux can improve CPU utilization and in some cases increase throughput You can disable auditing by appending audit 0 in the boot command line You can turn off SELinux by specifying selinux 0 in the boot command
117. hnical Support 1032 Start Authentication get config timed out The node authentication was aborted because waiting for port configuration to complete timed out Data None Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1033 Received auth_negotiate from Nport lt nlp DID gt Unsolicited authentication negotiation message received from a port Data 1 nlp_DID Severity Warning Log LOG_SECURITY Action No action this message is informational 1034 Not Expecting Challenge Rejecting Challenge Unsolicited authentication challenge received from a port was rejected Data None Severity Warning Log LOG_SECURITY Action Software driver warning If this issue persists report errors to the Technical Support elx mag1036 Authentication transaction reject re auth request reason lt reason gt exp lt explanation gt An authentication was rejected and requested again due to reason as displayed with explanation Data 1 reason 2 explanation Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1037 Authentication transaction reject restarting authentication reason lt reason gt exp lt explanation gt An authentication process was rejected then restarted and authentication requested again due to reason as displayed with explanation D
118. i_tape nstl 1IBM ULTRIUM TD2 1110133994 Creating the udev Persistent Name for SCSI Tape Device After you know the SCSI ID call needed to extract a unique ID use the same process to create a udev persistent name for a SCSI tape device as on a SCSI disk device The rule for the FC tape device is BUS scsi SYSFS vendor HP SYSFS model ULTRIUM 3 SCSI PROGRAM sbin scsi_id p 0x83 u g s sys class scsi_tape nst n RESULT 350060b000029b592 SYMLINK fc_ lun stn The rule for the FC SCSI tape device is BUS scsi SYSFS vendor IBM SYSFS model ULTRIUM TD2 PROGRAM sbin scsi_id p 0x83 u g s sys class scsi_tape nst n RESULT 1IBM ULTRIUM TD2 111013 3831 SYMLINK fc l n stn BUS scsi RESULT 1IBM ULTRIUM TD2 1110133994 SYMLINK fc_ lun stn Create a new file named etc udev rules d 45 local rules and put the appropriate rule in it Then run udevtrigger to reload the udev rules and the output of the rules will follow udevtrigger ls al dev fc lrwxrwxrwx 1 root root 3 Apr 7 15 03 fc lun st0 gt st0 lrwxrwxrwx 1 root root 3 Apr 7 15 03 fc _lun_stl gt stl Persistent Naming References See the following references for more information on persistent naming e http www reactivated net udevrules php by Daniel Drake dsd e http kernel org pub linux utils kernel hotplug udev_vs_devfs by Greg Kroah Hartman Emulex Drivers for Linux User Manual P007633 01B Rev A is
119. id slow path completion event majorcode x x minorcode x x n bf get lpfc_ege major code eqe bf _get lpfc_eqe minor code eqe SLI 4 The EQE is invalid Data None Severity Error Log LOG_SLI Action None required 0360 Unsupported EQ count lt entry count gt Cannot create an event queue of this size Data None Severity Error Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 73 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0361 Unsupported CQ count lt entry count gt Cannot create an completion queue of this size Data None Severity Error Log LOG_SLI Action None required 0362 Unsupported MQ count lt entry count gt Cannot create MQ of this size Data None Severity Error Log LOG_SLI Action None required 0364 Invalid param SLI 4 The post SGL function was passed an invalid XRI Data None Severity Error Log LOG_SLI Action None required 0365 Slow path CQ identifier lt CQID gt does not exist The Completion Queue ID passed in the event queue entry does not reference a valid completion queue Data None Severity Error Log LOG_SLI Action None required 0366 Not a valid fast path completion event majorcode lt major code hex gt minor code lt minor code hex gt The major or minor code in the Event Queue field is invalid D
120. ils The lpfc install uninstall script fails with an error Try the following solutions e Uninstall the OneCommand Manager application see the OneCommand Manager Application User Manual for instructions e Unmount all FC disk drives e Unload the lpfcdfc and FC and FCoE driver e Use rpm e lpfcdriver and e ocmanager and uninstall the new kits lpfc install script exit code Emulex Drivers for Linux User Manual The lpfc install script contains exit codes that can be useful in diagnosing installation issues See the lpfc install script for a complete listing of codes and definitions P007633 01B Rev A gt G EMULEX 4 Troubleshooting 51 Situations and their Resolutions Table 4 1 FC and FCoE Driver Situations and their Resolutions Continued Situation The Emulex driver for Linux does not load in ramdisk for a custom built kernel Resolution Custom built kernels are not supported by Emulex However the Emulex install script attempts to install the driver into a ramdisk that follows the naming scheme used by Red Hat or SLES kernels e The SLES naming scheme for an Intel Itanium IA64 ramdisk images is boot efi efi suse initrd e The SLES naming scheme for ramdisk images on all other architectures is boot initrd If a custom built kernel has a ramdisk image that does not follow the appropriate naming scheme the name of the image can be changed using the following procedure 1 Change
121. ing 89 Log Messages 0528 Mailbox CQ not allocated The mailbox CQ is not allocated Data None Severity Error Log LOG_INIT Action None required 0530 ELS CQ not allocated The ELS CQ is not allocated Data None Severity Error Log LOG_INIT Action None required 0534 Fast path FCP WQ lt fcp_wqidx gt not allocated The fast path FCP WQ is not allocated Data None Severity Error Log LOG_INIT Action None required 0535 Failed setup of fast path FCP WQ lt fcp _wqidx gt rc lt rc gt The fast path FCP WQ setup failed Data None Severity Error Log LOG_INIT Action None required 0536 Slow path ELS WO not allocated The slow path ELS WQ is not allocated Data None Severity Error Log LOG_INIT Action None required 0538 Slow path MQ not allocated The slow path MQ is not allocated Data None Severity Error Log LOG_INIT Action None required 0540 Receive Queue not allocated The Receive Queue is not allocated Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 9Q Log Messages gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0542 lpfc create static vport failed to allocate mailbox memory Failed to allocate mailbox memory for VPort creation Data None Severity Error Log LOG_INIT Action None
122. inimum value is 1 The maximum value is 255 The default value is 10 lpfc_topology For LightPulse adapters this parameter sets the link topology The possible values are e 0x0 loop first if loop fails then point to point default e 0x2 point to point only e 0x4 loop only 0x6 point to point first if point to point fails then loop Note For OneConnect UCNAs this parameter is not applicable lpfc_use_adisc When enabled an ADISC is sent instead of a PLOGI for device discovery or RSCN The enabled value is 1 The disabled value is 0 Configuring FC and FCoE Driver Parameters You can configure the FC and FCoE driver parameters by using e modprobe and etc modprobe conf e the sysfs interface to view and modify parameters after loading the FC and FCoE driver e the OneCommand Manager application See the OneCommand Manager Application User Manual for more information Note FC and FCoE driver parameter changes made using modprobe conf or the OneCommand Manager application persist if the FC and FCoE driver is uninstalled To return to the default settings you must reset them in the modeprobe conf file and reload the driver Configure Parameters with modprobe and etc modprobe conf The following sections describe how to set FC and FCoE driver parameters using the modprobe Linux program and by manually editing the etc modprobe conf file Temporary Configuration with modprobe When you manual
123. ir Descriptions Continued 0602 Failed to allocate CQ EVENT entry Failed to allocate a CQ_EVENT entry Data None Severity Error Log LOG_SLI Action None required 0603 Invalid work queue CQE subtype x x n cq lt subtype gt Invalid work queue CQE Data None Severity Error Log LOG_SLI Action None required 0700 Bus Reset on target lt i gt failed The bus reset for the specified target failed Data None Severity Error Log LOG_FCP Action None required 0704 At limitation of lt total gt preallocated command buffers The maximum number of command buffers have already been allocated Data None Severity Warning Log LOG_FCP verbose Action None required 0705 Allocation request of lt num gt command buffers will exceed max of lt hba_queue depth gt Reducing allocation request to lt size gt The number of command buffers requested will exceed the maximum so a smaller quantity will be allocated Data None Severity Warning Log LOG_FCP verbose Action None required 0708 Allocation request of lt num_to_alloc gt command buffers did not succeed Allocated lt num_allocated gt buffers The allocation request for the specified command buffers did not succeed However the specified number of buffers has been allocated Data None Severity Warning Log LOG_FCP Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Tr
124. is HBA 1057 Authentication transaction reject reason lt reason gt exp lt explanation gt An authentication was rejected and requested again due to the reason as displayed with the explanation Data 1 reason 2 explanation Severity Error Log LOG_SECURITY Action Software driver Error If this issue persists report errors to the Technical Support 1058 Waiting for authentication service There was a delay when the authentication service was not initially available as expected Data None Severity Warning Log LOG_SECURITY Action Software driver warning If this issue persists report these errors to Technical Support 1059 Authentication became available The authentication service came online but was not initially available as expected Data None Severity Warning Log LOG_SECURITY Action Software driver warning If this issue persists report these errors to Technical Support 1201 Failed to allocate dfc_host Failed to allocate memory for the dfc_host_struct Data None Severity Error Log LOG_ELS Action None required 1210 Invalid cmd size cmd lt cmd gt cmdsz lt cmdsize gt rspsz lt rspsize gt The management command for LPFC 2100 has failed Data None Severity Error Log LOG_LIBDFC Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 100 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and
125. ith the partition s persistent name For example kernel boot vmlinuz lt kernel version gt ro root dev disk by id scsi 32000000c5005d6e6 part2 4 Change any mounts listed in etc fstab which refer to this root partition by either its dev sd name or a file system label to use the persistent name as well Using udev with st Devices In Linux the driver for SCSI tape drives is st A tape device name has an st prefix The udev rules for tape devices are the same as for disk devices There must be a unique ID that persists across initiator reboots and persists regardless of discovery order You must consider whether the tape device is an FC tape device or an FC SCSI tape device in which there are multiple SCSI tape devices that reside behind an FC controller If it is an FC tape device then the WWPN is unique and can be used to create the persistent name In this case the scsi_id command should return this as the unique identifier with a single digit prefix If the FC controller has multiple SCSI tape devices behind it the WWPN is not unique and the persistent name must use multiple information elements to build the unique ID The following are examples of each scenario FC Tape Device Examples The following is an FC tape device example using the SCSI generic driver sg rather than the SCSI tape driver Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX 3 Configuration FC and FCoE Driver Configura
126. iver ParameterS sssssssssessssssesececessesssesecossessseceeeeeeee 18 Dynamic FC and FCoE Driver Parameters ccescceeceee cesses eeeetee tees eeeeeseeeenen 21 Configuring FC and FCoE Driver Parameter s cccccceescsccccessccceeeesscceeeees 22 Configure Parameters with modprobe and etc modprobe conf eeceeeeeee eens 22 Configure Parameters with a Read Write to SySfS ssssssssssesessesssesesessesssssseses 23 Creating a New Ramdisk IMAG s 0cicesaskstincanasnsasicanasceie tidus deceiraneseeeiicasadoas 24 Dynamically Recognizing LUNs and Targets USING SCAN cece eeeee eee eee eee eeeee 25 Persistent Naming sesvssviceed ane cede evar esvee eaten bodes dudes eoede EEE EERTE 25 Using udev to Discover Logical to Physical Mappings for sd Devices eeeeeees 25 Configuring the System to Boot Using Persistent Names eceeeeeeeeeeeeeeeeeeeeees 25 Using udev With St DeVICES cscissiressescisiiressisrisiiritsinris sE rekst itis ENEs T ESSERI R RRES 26 Persistent Naming References ssssssscssesossesesesescsesssecscocsoeseseseocsesesseeoseee 28 Emulex Drivers for Linux User Manual P007633 01B Rev A 5 gt lt EMULEX Table of Contents 6 Ethernet Driver Configuration esssseseccessccscsecocoseccosececosescosesecessscesosesee 29 Ethernet Driver Configuration Parameters ccccccesscccceeecccceeesssceeeeeseaes 29 VLAN Support on UMC wesncisee
127. k Up Event lt eventTag gt received A link up event was received It is possible for multiple link events to be received together Data 1 fc_eventTag 2 granted_AL_PA 3 UlnkSpeed 4 alpa_map 0 Detail If link events received log 1 last event number received 2 ALPA granted 3 Link speed 4 number of entries in the loop init LILP ALPA map An ALPA map message is also recorded if LINK_EVENT verbose mode is set Each ALPA map message contains 16 AL_PAs Severity Error Log Always Action If numerous link events are occurring check the physical connections to the FC network 1304 Link Up Event ALPA map A link up event was received Data 1 wd1 2 wd2 3 wd3 4 wd4 Severity Warning Log LOG_LINK_EVENT verbose Action If numerous link events are occurring check the physical connections to the FC network 1305 Link Down Event lt eventTag gt received A link down event was received Data 1 fc_eventTag 2 hba_state 3 fc_flag Severity Error Log Always Action If numerous link events are occurring check the physical connections to the FC network o 1306 Link Up Event in loop back mode x x received Data x x X X x x x x Link up notification configured for loopback Data 1 fc_eventTag 2 granted_AL_PA 3 UlnkSpeed 4 alpa_map 0 Severity Error Log LOG_LINK_EVENT Action None required 1308 Menlo Maint Mode Link up Event x x rcvd Data x x x x x x Link down noti
128. least 25 Secs Session Handle iSCSI initiator is only supported with certified targets Check for software updates at the target vendor s website and the Emulex website If this fails contact technical support Driver version does not match Firmware Please run Installer This failure indicates that the driver version that is running on the system does not match the version of the firmware flashed on the board This issue can be addressed by running the installer from the desired version Error during iSCSI offload Session Handle Firmware Error code Emulex Drivers for Linux User Manual This may indicate a target is in error or may point to transient network connectivity issues It may also indicate a firmware error P007633 01B Rev A gt G EMULEX 4 Troubleshooting 135 Log Messages Table 4 6 iSCSI Driver Error Log Messages Continued iSCSI Error Log Message Extended Timeout connection to target exceeded limits Session ID Expired Loss of ETO OxX Description Check the connection to the target or the state of the target device If the target is made available any sessions that existed previously will be reestablished and the devices will be available for 1 0 Initialization Failure This failure may be due to the firmware not being present or running currently This failure may also indicate a hardware issue Initialization failure during Power Managemen
129. led Data None Severity Error Log LOG_ELS Action Check the switch configuration 0258 Register Fabric login error The REG_LOGIN for the fabric has failed Data None Severity Error Log LOG_MBOX Action Check the port connection and the switch configuration 0259 No NPIV Fabric support The switch to which the port is connected does not support NPIV Data None Severity Error Log LOG_ELS Action Check the switch configuration 0260 Register NameServer error The REG_LOGIN mailbox command has failed for the NameServer Data None Severity Error Log LOG_ELS Action Check the switch configuration Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 62 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0261 Cannot register NameServer login Either a memory allocation issue or an invalid parameter was sent to the REG_LOGIN Data None Severity Error Log LOG_ELS Action At least one message 0142 0121 0133 0134 0135 should precede this message 0262 No NPIV Fabric support The switch to which the port is connected does not support NPIV Data None Severity Error Log LOG_ELS Action Check the switch configuration 0263 Discovery Mailbox error state Either the driver could not allocate resources or it could not send sparam_mbox or cfglink_mbox Data 1 address of sparam_mbox command
130. ly load the FC and FCoE driver as a module using the modprobe command and you change one or more driver parameter values in the command line the configuration is temporary These changes are considered temporary because they are valid for the current session only or until the FC and FCoE driver is unloaded Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 23 gt EMULEX FC and FCoE Driver Configuration Modprobe uses the modprobe conf file but parameters passed to it using the command line override the parameters in the modprobe conf file Values can be expressed in hexadecimal or decimal notation If you want to temporarily set lun_queue_depth to 20 default is 30 for all HBAs in your system load the FC and FCoE driver with the following command modprobe lpfc lpfc_ lun queue depth 20 Persistent Configuration with etc modprobe conf To make the FC and FCoE driver parameters persist across module loads and reboots modify the etc modprobe conf file If driver parameters are modified in etc modprobe conf the FC and FCoE driver must be reloaded for the parameters to take effect Also a new ramdisk image is required if you want the changes to take effect in the next boot See Creating a New Ramdisk Image on page 24 The FC and FCoE driver parameters are specified in etc modprobe conf via the options command For example the following command sets the verbose flag options lpfc lpfc_ log
131. ly supported with certified targets Management Function Task Management Function code 0xX Session Handle 0xX Check for software updates at the target vendor s axCmdSN 0xX website and the Emulex website If this fails contact ExpCmdSN 0xX technical support Received unsupported Task The operating system version is not supported Rejected IOCTL since buffer size limit exceeded Subsystem Opcode 0xX 0xX This error may indicate an incorrect configuration option for the iSCSI driver It may also indicate a low memory condition Payload Length 0xX Unrecoverable Error This may be due to hardware errors or due to unhandled UE LOW 0xX exceptions in the hardware or firmware UE HIGH 0xX Firmware Line Number 0xX Emulex Drivers for Linux User Manual P007633 01B Rev A Appendix A Open iSCSI Support 136 gt EMULEX Connecting to the iSCSI Target Appendix A Open iSCSI Support Open iSCSI is a high performance transport independent multi platform implementation of Request for Comments RFC 3720 The inbox Open iSCSI driver is supported However for driver versions earlier than RHEL 6 2 and SLESS 11 SP2 due to limitations in some Open iSCSI distribution tools the inbox driver does not support ISNS or iSCSI boot If you need to use ISNS or iSCSI boot use the out of box iSCSI driver provided by Emulex For the inbox Open iSCSI driver use the Open iSCSI tools to configure a
132. meter Description Visible lpfc_enable_hba_reset When enabled the FC and FCoE drivers can pass resets to the Yes adapter This is typically used for debugging purposes The enabled value is 1 default The disabled value is 0 lpfc_enable_npiv When enabled the FC and FCoE driver can use NPIV to create Yes VPorts if supported by the fabric The enabled value is 1 default The disabled value is 0 lpfc_fcp_class Specifies either FC Class 2 or 3 for FCP data transmission For Yes Class 2 the value is 2 For Class 3 the value is 3 default lpfc_fcp_eq_count For OneConnect UCNAs specifies the number of fast path FCP Yes event queues if available The minimum value is 1 The maximum value is 8 The default value is 4 Note For LightPulse adapters this parameter is not applicable and has no effect ipfc_fcp_imax For OneConnect UCNAs specifies the maximum number of Yes fast path FCP interrupts per second The minimum value is 636 The maximum value is 651042 The default value is 10000 Note For LightPulse adapters this parameter is not applicable and has no effect ipfc_fcp_wq_count For OneConnect UCNAs specifies the number of fast path FCP Yes work queues if available The minimum value is 1 The maximum value is 32 The default value is 4 Note For LightPulse adapters this parameter is not applicable and has no effect lpfc_hba_queue_depth Specifies the maximum number of FCP commands that can queue Yes to an Emulex adapter The mi
133. n None required 2622 Query Firmware Config failed mbx status lt rc gt status lt shdr_status gt add_status lt shdr_add_status gt Could not read the firmware configuration Data None Severity Error Log LOG_SLI Action None required 2623 FCoE Function not supported by firmware Function mode lt function_mode gt gt FCoE is not supported by this firmware Data None Severity Error Log LOG_SLI Action Use the OneCommand Manager application to update to the latest firmware 2707 Ring lt Ring gt handler Failed to allocate iocb Rctl lt fh_rctl gt Type lt fh_type gt received The driver was unable to allocate memory to send a query config mailbox command Data None Severity Error Log LOG_SLI Action None required 2717 CT context array entry lt index gt over run oxid lt fh_ox_id gt sid lt fh_SID gt All of the array slots to hold buffers that are passed to the application are in use Data None Severity Warning Log LOG_ELS Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 130 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2718 Clear Virtual Link Received for VPI lt index gt tag lt event_tag gt A Clear virtual link was received from the Fabric for this VPI Data None Severity Error Log LOG_DISCOVERY Action None required 2719
134. n RPI or DMA buffer for the mailbox command Data 1 nlp_DID 2 nlp_state 3 nlp_flag 4 nlp_rpi Severity Error Log LOG_ELS Action None required 0136 PLOGI completes to NPort lt DID gt completion A PLOGI has completed for which there is no NDLP Data 1 ulpStatus 2 ulpWord 4 Severity Error Log LOG_ELS Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 4 Troubleshooting 56 Log Messages 0137 No retry ELS command lt ELS_CMD gt to remote Data 1 ulpStatus 2 ulpWord 4 Severity Error Log LOG_ELS Action None required 0138 ELS rsp Cannot issue reg login for lt DID gt REG_LOGIN mailbox command failed Data 1 nlp_DID 2 nlp_state 3 nlp_flag 4 nlp_rpi Severity Error Log LOG_ELS Action None required 0139 Ignoring ELS cmd tag lt ioTag gt completion Data This ELS command was aborted Data 1 ulpStatus 2 ulpWord 4 3 ulpTimeout Severity Error Log LOG_ELS Action None required 0140 PLOGI Reject invalid name Invalid node WWN provided Data None Severity Error Log LOG_ELS Action None required 0141 PLOGI Reject invalid pname Invalid port WWN provided Data None Severity Error Log LOG_ELS Action None required 0142 PLOGI RSP Invalid WWN The PLOGI sent to the port by a remote port had an invalid WWN Da
135. n to a particular target given the adapter s host number in this example 3 and the target number in this example 2 type echo 2 gt sys class scsi_host host3 scan You can also use the Emulex lun_scan script in the usr sbin Ipfc directory Persistent Naming The generic device manager for the Linux kernel is udev which primarily manages device nodes in the dev directory Using udev to Discover Logical to Physical Mappings for sd Devices In Linux the driver for SCSI disk drives is sd A disk device name has an sd prefix Persistent names for sd devices are provided in the dev disk by id directory To find the persistent udev name for the disk which is currently sdc type cd dev disk by id ls 1 grep sdc The sample output is lrwxrwxrwx 1 root root 9 2006 08 01 19 08 scsi 32000000c5005d6e6 gt sdc In the previous example the disk has no partitions If the disk had two partitions the output would look like the following lrwxrwxrwx 1 root root 9 2006 08 01 19 08 scsi 32000000c5005d6e6 gt sdc lrwxrwxrwx 1 root root 10 2006 08 01 19 08 scsi 32000000c5005d6e6 partl gt sdcl lrwxrwxrwx 1 root root 10 2006 08 01 19 08 scsi 32000000c5005d6e6 part2 gt sdc2 Configuring the System to Boot Using Persistent Names For SLES 10 SPx and SLES 11 SPx Note SLES 10 SPx and SLES 11 SPx are configured by default with udev to provide persistent names for hard disks including F
136. nd manage Open iSCSI For the Emulex out of box iSCSI driver use the Emulex OneCommand Manager application to configure and manage Open iSCSI The applications are not interchangeable between the drivers The iscsiadm utility is a command line tool allowing discovery of iSCSI targets logging into iSCSI targets as well as access and management of the open iSCSI database on all Linux installations This utility presents a set of operations that you can perform on iSCSI nodes sessions connections and discovery records Connecting to the iSCSI Target After setting up the target and initiator machines use the following procedure to discover the targets and create iSCSI connections through Open iSCSI Note The following instructions assume that the initiator machine is a Linux machine with a OneConnect UCNA installed 1 Create a new interface iface iscsiadm m iface o new I lt ifacename gt In this command lt ifacename gt is the name you provide for the iface 2 Adda NIC media access control MAC address iscsiadm m iface I lt iface name gt op update n iface hwaddress v lt NIC mac_address gt In this command lt ifacename gt is the name of the iface created in step 1 and lt NIC mac_address gt is the NIC MAC address you are adding for discovery 3 Add the Transport Name iscsiadm m iface I lt ifacename gt op update n iface transport name v be2iscsi In this command lt ifacename gt is the name of the
137. nding mailbox command was aborted because the thread received a signal Data None Severity Error Log LOG_VPORT verbose Action You should retry the attempted command 1831 Create VPORT Interrupted The port creation process was unexpectedly interrupted at a critical time and the operation was unsuccessful Data None Severity Error Log LOG_VPORT verbose Action The process was interrupted while creating a VPort Retry the command Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 113 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 1832 No pending MBOX command to handle Data None Severity Error Log LOG_MBOX Action None required 1835 Vport discovery quiesce failed state lt port_state gt fc flags lt fc_flag gt wait msecs lt jiffies to_msecs jiffies start_time gt Could not pause discovery on this VPort Data None Severity Error Log LOG_VPORT Action None required 1836 Could not issue unreg login all_rpis status lt rc gt The unreg_login cannot be issued Data None Severity Error Log LOG_MBOX LOG_VPORT Action None required 1837 Vport_delete failed Cannot delete static vport Static VPorts cannot be deleted Data None Severity Error Log LOG_VPORT Action None required 1838 Failed to INIT VPI on vpi lt vpi gt status lt rc gt Failed to INIT_VPI Data No
138. ne Severity Error Log LOG_VPORT Action None required 2000 Failed to allocate mbox for read FCF cmd Failed to allocate mailbox for READ_FCF command Data None Severity Error Log LOG_INIT Action None required 2001 Unable to allocate memory for issuing SLI_CONFIG SPECIAL mailbox command Unable to allocate memory for issuing the SLI_CONFIG_SPECIAL mailbox command Data None Severity Error Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 114 Log Messages gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2002 Error Could not grow rpi count An error occurred because the RPI count could not be increased Data None Severity Error Log LOG_SLI Action None required 2004 Failed to allocate XRI last XRITAG is lt XRI gt Max XRI is lt MAX XRI gt Used XRI is lt USED_XRI gt All XRIs are in use Data None Severity Warning Log LOG_SLI Action None required 2005 Unable to deregister pages from HBA lt rc gt The SGL pages could not be unregistered from the firmware Data None Severity Error Log LOG_SLI Action None required 2007 Only Limited Edition cmd Format supported lt iocb ulpCommand gt The SGL pages could not be unregistered from the firmware Data None Severity Error Log LOG_SLI Action None required 2008 Error lt rc
139. ng on the type needed The disabled value is 0 default pfc_link_speed Specifies the FC link speed The possible values are e 0 Auto select default e 1 1 Gb s e 2 2 Gb s e 4 4Gb s e 8 8 Gb s e 16 16 Gb s Note This parameter does not affect FCoE 10 Gb s adapters pfc_log_verbose Specifies the log verbosity level of the messages posted by the driver Extra activity logging bit mask The minimum value is 0x0 default The maximum value is OxFFFF pfc_nodev_tmo deprecated Note This is a deprecated field and lpfc_devloss_tmo should be used instead This parameter will not work if you altered lpfc_devloss_tmo Specifies the number of seconds to hold an I O error when a device disappears The minimum value is 1 The maximum value is 255 The default value is 30 ipfc_pci_max_read Emulex Drivers for Linux User Manual Specifies the maximum DMA read byte count The possible values are 512 1024 2048 default and 4096 P007633 01B Rev A gt G EMULEX 3 Configuration 22 FC and FCoE Driver Configuration Table 3 2 Dynamic FC and FCoE Driver Parameters Continued Parameter Description lpfc_poll Sets the FCP ring polling mode control The possible values are e 0 no polling default e 1 poll with interrupts enabled e 3 poll and disable FCP ring interrupts lpfc_poll_tmo Specifies the number of milliseconds that the driver waits between polling FCP ring interrupts The m
140. ng from a Non Zero LUN Attached to an Emulex LPFC Adapter This section describes how to configure SLES 10 SPx or SLES 11 SPx to boot from an FC attached disk device other than dev sda This example uses dev sdb To boot from a non zero LUN attached to an Emulex LPFC adapter 1 2 3 ol 10 11 Configure the Emulex adapter to boot from the desired LUN Start the standard SLES 10 SPx or SLES 11 SPx installation At the Installation Settings screen after configuring the desired partitions select the Expert tab Select Booting to change the bootloader configuration The Boot Loader Settings window appears Select the Boot Loader Installation tab In the section labeled Boot Loader Location select Custom Boot Partition then select root partition or boot partition if you configured one from the drop down box Click Boot Loader Options The Boot Loader Options window appears Select Write generic Boot Code to MBR Click OK In the Boot Loader Settings window click Finish Proceed with the installation During the first boot after the installation use the GRUB command line to change all hd1 references to hd0 then continue the boot process Edit the GRUB configuration in boot grub menu lst to change all hd1 references to hd0 OneCommand Manager Application The OneCommand Manager application is a powerful centralized adapter management suite providing discovery reporting and management of local and remote ada
141. ng insmod is the default ETO value that is applied to all targets The following example configures the LDTO and ETO during insmod of the driver These settings must be used every time the iSCSI driver is loaded by insmod insmod be2iscsi ko ldto 25 eto 20 To pass module parameters to the iSCSI driver when it is being used as a boot controller edit the file or the etc modprobe conf file For example add the following line options be2iscsi ldto 25 eto 20 Then type mkinitrd The change takes effect the next time the system is booted For information on these parameters in relation to SCSI error handling see Error Handling using ETO and LDTO Parameters on page 33 Configuring the large_io Parameter The large I O large_io parameter specifies the maximum transfer size in a single SCSI command of 128 or 512 KB By default large_io 128 which means the iSCSI driver supports up to 128 KB and 32 scatter gather entries in a single SCSI command If applications issue I O requests that are larger than 128 KB or need more than 32 scatter gather entries the request is split into multiple requests by the driver When large_io 512 the iSCSI driver can support up to 512 KB of data and a total of 128 scatter gather entries in a single SCSI command In this case the iSCSI driver supports a larger maximum transfer size but also consumes a larger amount of physical memory Intermediate sizes between 64 and 512 KB are accepted bu
142. nimum value is 32 The maximum value is 8192 default lpfc_lun_queue_depth Specifies the default maximum commands sent to a single logical Yes unit disk drive The minimum value is 1 The maximum value is 128 The default value is 30 lpfc_max_luns Specifies the highest available LUN ID per target that are valid Yes Emulex Drivers for Linux User Manual For example a value of 19 means LUN IDs from 0 to 19 are valid The SCSI layer scans each target until it reaches the specified LUN ID The minimum value is 0 The maximum value is 65535 The default value is 255 P007633 01B Rev A 19 gt G EMULEX 3 Configuration 20 FC and FCoE Driver Configuration Table 3 1 Static FC and FCoE Driver Parameters Continued sysfs Parameter Description Visible lpfc_max_scsicmpl_time Uses command completion time to control queue depth The Yes units are in milliseconds The minimum value is 0 default The maximum value is 6000 pfc_multi_ring_rctl When lpfc_multi_ring_support is enabled identifies the routing Yes control R_CTL for additional ring configuration The minimum value is 1 The maximum value is 255 The default value is 4 pfc_multi_ring_support Determines the number of primary SLI rings over which to spread Yes IOCB entries The minimum value is 1 default The maximum value is 2 pfc_multi_ring_type When lpfc_multi_ring_support is enabled identifies the TYPE for Yes additional ring c
143. nterrupt moderation algorithm is turned off in the driver 1 Aggressive Highest interrupt rate among available settings 2 Moderate Default value The interrupt rate varies between 3500 to 10000 interrupts per second 3 Conservative Lower interrupt rate than Moderate 4 Very conservative The minimum interrupt rate among available settings By default the driver implements an interrupt moderation scheme that is based on the I O load and the interrupt rate Changing the interrupt moderation policy setting should be based on the initiator system configuration the number of connected iSCSI targets the I O load and the throughput and latency offered by these iSCSI targets The default Moderate setting im_policy 2 varies the interrupt rate between 3500 to 10000 interrupts per second While the Moderate setting may work for most configurations there are instances when the setting may need to be altered On systems capable of sustaining a higher interrupt rate and when a few number of targets are connected up to 8 the Aggressive setting im_policy 1 results in lower latency and higher values of I O operations per second IOPs However this higher interrupt rate could also result in system stalls and freezes especially during higher values of queue depth and smaller sized I O requests In a configuration that involves a large number of iSCSI targets more than 32 or 64 and higher values of queue depth the Conservative im_policy
144. nued 2510 RQ DESTROY mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to delete the work queue has failed Data None Severity Error Log LOG_INIT Action None required 2511 POST SGL mailbox failed with status lt shdr_ status gt add status lt shdr_add_status gt mbx status lt rc gt n The mailbox command sent to post the SGL pages to the firmware has failed Data None Severity Error Log LOG_INIT Action None required 2512 REMOVE ALL SGL PAGES mailbox failed with status lt shdr_status gt add_status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to delete the SGL pages from the firmware has failed Data None Severity Error Log LOG_INIT Action None required 2513 POST SGL BLOCK mailbox command failed status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to post the SGL pages to the firmware has failed Data None Severity Error Log LOG_INIT Action None required 2514 POST RPI HDR mailbox failed with status lt shdr_status gt add_status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to post the RPUI header pages to the firmware has failed Data None Severity Error Log LOG_INIT Action None required 2515 ADD FCF RECORD mailbox failed with status lt rc gt
145. of range Data None Severity Error Log LOG_SLI Action None required 0373 FCP complete error status lt status gt hw_status lt hw status gt total data_specified lt total data transferred gt parameter lt rsp word 4 gt word3 lt wcqe word 3 gt Logs the FCP failure Status and parameter are equivalent to ulpStatus and ulpWord 4 Data None Severity Warning Log LOG_SLI Action None required 0374 FCP complete with no corresponding cmdiocb iotag lt iocb iotag gt There was no IOCB on the in progress list that matched this iotag Data None Severity Warning Log LOG_SLI Action None required 0375 FCP cmdiocbh not callback function iotag lt iocb iotag gt The IOCB found for this iotag does not have a completion handler set in it Data None Severity Warning Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 75 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0377 Error lt rc gt parsing vpd Using defaults Could not parse the VPD data so the driver is using the default values Data None Severity Error Log Always Action None required 0378 No support for fcpi mode Could not configure the port to run in FCP initiator mode Data None Severity Warning Log LOG_MBOX LOG_SLI Action None required 0379 Feature Mismatch Data lt req ftr
146. og LOG_INIT Action Issue an HBA reset 0474 Unable to allocate memory for issuing MBOX CONFIG MSI command Mailbox memory pool allocation error Data None Severity Error Log LOG_INIT Action None required o 0475 Not configured for supporting MSI X cfg _ use msi 0x x The lpfc_use_msi module parameter should have been set to 2 Data None Severity Error Log LOG_INIT Action Set module parameter lpfc_use_msi 2 0476 HBA not supporting SLI 3 or later SLI Revision lt sli_rev gt The HBA does not support SLI 3 or SLI 4 Data None Severity Error Log LOG_INIT Action This HBA does not support msi Set pfc_use_msi 0 0478 MSI request_irg failed lt rc gt The request_irq kernel API has failed Data None Severity Warning Log LOG_INIT Action Set lpfc_use_msi 0 0479 Deferred Adapter Hardware Error An adapter hardware error was sent to the driver Data 1 work_hs 2 work_status 0 3 work_status 1 Severity Error Log LOG_INIT Action Perform a dump using hbacmd 0483 Invalid link attention link speed x x bf get lpfc_acqe link speed acqe link The link speed reported in the link attention interrupt is invalid Data None Severity Error Log LOG_INIT Action Check the switch configuration Emulex Drivers for Linux User Manual P007633 01B Rev A gt EMULEX 4 Troubleshooting 86 Log Messages Table 4 4 LPFC Error Log Messages and their Descrip
147. on you must use the etc init d fcauthd script The script syntax is etc init d fcauthd lt parameter gt fcauthd Daemon Parameters The fcauthd daemon supports the following parameters e start To start the feauthd daemon pass the start command to the fcauthd script This command loads the daemon into memory opens a netlink connection for the driver and reads the authentication configuration database into memory for use by the LPFC driver e stop To stop the fcauthd daemon pass the stop command to the fcauthd script This command takes down the netlink connection between the fcauthd daemon and the LPFC driver and stops the fcauthd daemon e reload The reload command reloads the authentication configuration database into memory This is done whenever the database is changed by another application such as the OneCommand Manager application or by you If the database is changed the new configuration information is not used until the fcauthd daemon reloads the database e status This command displays the current status of the fcauthd daemon The status should be either running or stopped Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 42 gt G EMULEX Network Performance Tuning e restart The restart command stops the fcauthd daemon and then restarts it e condrestart The conditional restart command checks the status of the fcauthd daemon If it is running it issues a stop and then a sta
148. onfiguration The minimum value is 1 The maximum value is 255 The default value is 5 LLC SNAP lpfc_restrict_login When enabled restricts VPorts login to remote initiators The No enabled value is 1 default The disabled value is 0 lpfc_scan_down When enabled selects the method for scanning the AL_PA from Yes high to low to assign a SCSI ID The enabled value is 1 default The disabled value is 0 lpfc_sg_seg_cnt Controls the scatter gather maximum segment count passed to Yes the FC and FCoE driver This variable is applicable per SCSI sg_table command size For LightPulse adapters the minimum value is 64 default and the maximum value is 4096 For SLI 4 OneConnect UCNAs the values are restricted by the FC and FCoE driver to specific values due to restrictions imposed by the hardware The possible values are 50 default 114 242 and 498 lpfc_sli_mode For LightPulse adapters this parameter allows you to force the No SLI mode requested by the adapter driver The possible values are e 0 Auto select default e 2 SLI 2 e 3 SLI 3 Note For OneConnect UCNAs this parameter is not applicable and has no effect pfc_use_msi When enabled determines whether the driver uses MSI or MSI X Yes Emulex Drivers for Linux User Manual e 0Q MSI disabled INTx mode is used default for FC 8 2 0 x drivers e 1 AMSI allows a maximum of 32 interrupts e 2 AMSI X allows a maximum of 2048 interrupts default for FC 8 3 5 x drivers
149. or Log Messages and their Descriptions Continued 0224 NameServer Query timeout Node authentication timeout node Discovery timeout A NameServer Query to the Fabric or discovery of reported remote N_Ports is not acknowledged within R_A_TOV Data 1 fc_ns_retry 2 fc_max_ns_retry Severity Error Log Always Action Check Fabric configuration The driver recovers from this and continues with device discovery 0226 Device discovery completion error This indicates that an uncorrectable error was encountered during device re discovery after a link up FC devices will not be accessible if this message is displayed Data None Severity Error Log Always Action Reboot the system If this issue persists report the error to Technical Support Run with verbose mode on for more details 0227 Node Authentication timeout The driver has lost track of what N_Ports are being authenticated Data None Severity Error Log Always Action None required The driver should recover from this event 0228 CLEAR LA timeout The driver issued a CLEAR_LA that never completed Data None Severity Error Log Always Action None required The driver should recover from this event 0230 Unexpected timeout hba linkstate lt link _ state gt Discovery has timed out and the HBA state is not ready Data None Severity Error Log LOG_DISCOVERY Action None required 0231 RSCN timeout The driver has l
150. or to Technical Support 0449 lpfc Sattr attribute cannot be initialized to d allowed range is min Smax The sysfs attribute value written exceeds attribute range Data 1 attribute name 2 value written 3 minimum value 3 maximum value Severity Error Log Always Action Write a value within the supported range Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 83 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0450 Ipfc _ attr attribute cannot be set to d allowed range is min max The sysfs attribute value written exceeds attribute range Data 1 attribute name 2 value written 3 minimum value 3 maximum value Severity Error Log Always Action Write a value within the supported range 0451 Enable interrupt handler failed The driver attempted to register the HBA interrupt service routine with the host operating system but failed Data None Severity Error Log Always Action This error could indicate a hardware or driver issue If this issue persists report the error to Technical Support 0453 Adapter failed to init mbxCmd lt mbxCommand gt READ CONFIG mbxStatus lt mbxStatus gt Adapter initialization failed when issuing a READ_CONFIG mailbox command Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the er
151. or unrecoverable error the driver detected an invalid SLI revision Data None Severity Error Log LOG_INIT Action None required 0300 LATT Cannot issue READ LA Data lt rc gt The link attention handler could not issue a READ_LA mailbox command Data None Severity Error Log LOG_MBOX Action None required 0301 READ SPARAM no buffers The driver attempted to issue a READ_SPARAM mailbox command to the adapter but there were no buffers available Data None Severity Warning Log LOG_MBOX verbose Action This message indicates 1 Kernel virtual memory is depleted Check that the system meets minimum RAM requirements for the Emulex FC adapter Try closing other applications to free some memory 2 A possible driver buffer management issue If this issue persists report the error to Technical Support 0302 REG LOGIN no buffers The driver attempted to issue a REG_LOGIN mailbox command to the adapter but there no buffers were available Data 1 Did 2 flag Severity Warning Log LOG_MBOX verbose Action This message indicates 1 Kernel virtual memory is depleted Check that the system meets minimum RAM requirements for the Emulex FC adapter Try closing other applications to free some memory 2 A possible driver buffer management issue If this issue persists report the error to Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 67 DG E
152. ory channels or memory interleaves which may not be enabled by default Check the manufacturer s documentation and BIOS parameters for details on enabling optimal memory bandwidth options Populate DIMM Slots Typically all the dual in line memory module DIMM slots must be populated to make use of all the memory channels As a general rule using more DIMMs provides better performance by allowing a higher degree of memory access interleaving to occur Emulex Drivers for Linux User Manual P007633 01B Rev A 3 Configuration 43 Network Performance Tuning gt G EMULEX Disabling Memory Mirroring Some servers may allow memory mirroring where the total memory is divided in half and each location is stored twice This allows fault recovery if one memory location detects an error but it greatly reduces the perceived memory bandwidth of the system Consider disabling memory mirroring if it is not needed Using a Fast Clock Speed for the Front Side Bus FSB Nearly any desktop or low end server has enough memory bandwidth for OneConnect UCNAs to support DMA at 20 Gb s of data 10 Gb s read 10 Gb s write However most of the memory demands come from the processor accessing the data for either packet copies in the non offloaded networking stack or application accesses All processor memory accesses use the FSB The clock speed of this bus is critical for allowing efficient memory bandwidth A system with a faster processor FSB clock spee
153. ost track of what N_Ports have RSCNs pending Data 1 fc_ns_retry 2 lpfc_max_ns_retry Severity Error Log Always Action None required The driver should recover from this event 0233 Nodelist not empty Driver unloaded or hotplug detected a node still in use Data None Severity Error Log LOG_DISCOVERY Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 60 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0237 Pending Link Event during Discovery State lt hba_state gt Received link event during discovery Causes discovery restart Data None Severity Warning Log LOG_DISCOVERY verbose Action None required unless this issue persists If persistent check cabling 0241 NameServer rsp error The driver received a NameServer response containing a status error Data 1 CommandResponse bits CmdRsp 2 ReasonCode 3 Explanation 4 fc_flag Severity Error Log LOG_DISCOVERY verbose Action Check the fabric configuration The driver recovers from this and continues with device discovery 0246 RegLogin failed The firmware returned a failure for the specified RegLogin Data 1 Did 2 mbxStatus 3 hbaState Severity Error Log Always Action This message indicates that the firmware could not do RegLogin for the specified DID There may be a limitation on how many nodes an HBA can see 0249
154. oubleshooting 92 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0711 detected queue full lun queue depth adjusted to d The driver detected a queue full status on a SCSI command response New LUN queue depth is reported Data 1 New LUN queue depth Severity Warning Log LOG_FCP verbose Action This may indicate an oversubscribed target array Check your SAN configuration and I O workload 0713 SCSI layer issued Device Reset d d A device reset was issued Data None Severity Error Log LOG_FCP Action None required 0714 SCSI layer issued bus reset The SCSI layer is requesting the driver to abort all I Os to all targets on this HBA Data 1 ret Severity Error Log Always Action Check the state of the targets in question 0720 FCP command lt cmnd 0 gt residual overrun error A residual overrun error has occurred while processing the specified FCP command Data 1 request_bufflen 2 resid Severity Warning Log LOG_FCP verbose Action If this issue persists check the targets for errors 0721 Device Reset rport failure rdata lt rdata gt The reset of the R_Port failed Data None Severity Error Log LOG_FCP Action None required 0722 Target Reset rport failure rdata lt rdata gt The reset of the target failed Data None Severity Error Log LOG_FCP Action None required 0723 SCSI layer issued Target Res
155. ould indicate a software driver firmware or hardware issue Report these errors to Technical Support 0317 iotag lt ulp_IoTag gt is out of range max iotag lt max_iotag gt wd0 lt wd0 gt The loTag in the completed IOCB is out of range Data None Severity Error Log Always Action This error could indicate a software driver firmware or hardware issue Report these errors to Technical Support 0318 Failed to allocate IOTAG last IOTAG is lt last_allocated_iotag gt The driver cannot allocate an loTag Display the last value used Data None Severity Error Log Always Action This message indicates the adapter HBA I O queue is full Typically this happens when heavy I O is running on a low end 3 digit adapter We suggest you upgrade to a higher end adapter 0319 READ SPARAM mbxStatus error lt mbxStatus gt hba state lt hba_state gt The driver issued a READ_SPARAM mailbox command to the HBA that failed Data None Severity Error Log Always Action This error could indicate a firmware or hardware issue Report these errors to Technical Support 0320 CLEAR LA mbxStatus error lt mbxStatus gt hba state lt hba_state gt The driver issued a CLEAR_LA mailbox command to the HBA that failed Data None Severity Error Log Always Action This error could indicate a firmware or hardware issue Report these errors to Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A
156. pause rx on ethtool A lt ethN gt pause rx off where eth lt N gt is the name of the Ethernet device you are working on for example eth0 Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 45 gt lt EMULEX Network Performance Tuning You can configure the UCNA to send flow control pause frames using the following ethtool commands ethtool A lt ethN gt pause tx on ethtool A lt ethN gt pause tx off where eth lt N gt is the name of the Ethernet device you are working on for example eth0 RX and TX flow control are enabled by default in the OneConnect UCNA When priority flow control is enabled in the adapter normal flow control cannot be enabled Refer to the switch router documentation to determine how link level flow control can be configured on the switch router to which the OneConnect UCNA port is connected Note In multichannel configurations where multiple PCI functions are exposed for a single 10G Ethernet port the flow control parameter for a port can be configured through any interface associated with the physical port and the configured property will apply to all interfaces associated with the port RX Frame Coalescing The OneConnect ethernet driver coalesces regular sized TCP segments to a large frame before passing it to the network stack which may improve TCP receive performance RX frame coalescing is implemented using the GRO mechanism in Linux driver versions that suppor
157. pters from a single console anywhere in the SAN and across platforms Both a GUI and CLI are provided This remote configuration capability can be provided by either FC access via host systems on the same FC SAN or by TCP IP access from IP addresses of remote machines For instructions on installing and using the OneCommand Manager application see the latest OneCommand Manager Application User Manual which is available on the Emulex website Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX 3 Configuration 18 FC and FCoE Driver Configuration 3 Configuration FC and FCoE Driver Configuration FC and FCoE Driver Parameters The FC and FCoE driver parameters determine some aspects of the driver s behavior There are two main types static and dynamic Changes to the static parameters require a driver reload for the change to take effect Changes to the dynamic parameters take effect immediately See the following section and Dynamic FC and FCoE Driver Parameters on page 21 respectively Static FC and FCoE Driver Parameters Changes to static parameters require a driver reload for the change to take effect Table 3 1 lists the static FC and FCoE driver parameters Table 3 1 Static FC and FCoE Driver Parameters Parameter lpfc_ack0 Description When enabled ACKO is used for Class 2 The enabled value is 1 The disabled value is 0 default sysfs Visible Yes lpfc_dev_loss_initiator
158. r Log LOG_INIT Action Ensure the adapter firmware is current Reload the driver 0460 Bring adapter offline The FC driver has received a request to bring the adapter offline This may occur when running putil Data None Severity Warning Log LOG_INIT verbose Action None required 0466 Outstanding IO when bringing Adapter offline The 1 0 is still pending while attempting to stop the driver Data None Severity Warning Log LOG_INIT Action None required 0467 lpfc_topology attribute cannot be set to d allowed range is 0 6 phba gt brd_no val The lpfc_topology module parameter is invalid Data None Severity Error Log LOG_INIT Action Use a value in the valid range 0468 lpfc_restrict_login must be 0 for Physical ports vport gt cfg restrict login 0 Cannot restrict the login for the physical port Data None Severity Error Log LOG_INIT Action None required 0469 lpfc_link speed attribute cannot be set to d allowed range is 0 8 The link speed module parameter is invalid Data None Severity Error Log LOG_INIT Action Use a link speed parameter in the valid range Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 85 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0472 PCI channel I O permanent failure The PCI bus has detected an error Data None Severity Error L
159. r Kit Note You must run the uninstall script that shipped with the version of the driver kit you want to remove To uninstall the binary RPM FC and FCoE driver 1 2 Log on as root If possible exit all applications that use FC attached drives then unmount the drives If you cannot exit all applications that use FC attached drives the uninstall works properly but you must reboot after the uninstallation is complete Run the elx_lpfc_install sh script with the uninstall option elx lpfc_install sh uninstall Ethernet Driver Kit The Ethernet driver kit includes the driver that supports the NIC protocol The Ethernet driver kit contains the following e lt A zipped tar file that includes the driver binary RPMs for a specific driver version and for all of the supported Linux distribution kernels Emulex Drivers for Linux User Manual P007633 01B Rev A 2 Installing and Uninstalling 15 DG EMULEX Ethernet Driver Kit Note Use only officially released Linux distribution kernels The binary RPM packages only support officially released Linux distribution kernels and do not support pre release distribution kernels An installation script elx_net_install sh that installs by default the Ethernet driver binary RPM that corresponds to the target system s architecture and kernel memory variant A README file that provides a description of the kit structure its contents and distribution suppo
160. r SCSI discovery when the command to create a VPort is finished Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 41 gt lt EMULEX DHCHAP Authentication and Configuration DHCHAP Authentication and Configuration Note This section is applicable to FC 8 2 0 x drivers only To activate FC SP Authentication between the adapter host port and fabric F_Port using DHCHAP modify the DHCHAP associated driver properties in the driver configuration file The LPFC driver for Linux version 8 2 0 x supports MD5 and SHA 1 hash functions and supports the following DH groups Null 1024 1280 1536 and 2048 Enabling Authentication Enabling authentication is a two step process To enable authentication 1 Start the fcauthd daemon 2 Set the lpfc_enable_auth module parameter to 1 enabled fcauthd Daemon The LPFC driver requires the fcauthd daemon to perform authentication tasks for it To enable authentication you must have this daemon running If you want to load the LPFC driver with authentication enabled the fcauthd daemon should be running before the driver is loaded The LPFC driver can start with authentication enabled if the daemon is not running but all ports are placed into an error state When the daemon is started the LPFC driver should discover the daemon and reset the adapter to enable the LPFC driver to perform authentication To test if this daemon is running start the daemon or stop the daem
161. range 0404 lpfc_devloss tmo attribute cannot be set to lt val gt allowed range is lt LPFC MIN DEVLOSS TMO gt lt LPFC MAX DEVLOSS TMO gt Attempt to set the devloss timeout value is outside the allowed range Data None Severity Error Log LOG_INIT Action Set the devloss timeout between the minimum and maximum devloss range 0405 lpfc_link speed attribute cannot be set to d allowed values are LPFC_LINK_SPEED STRING Attempt to set the link speed value is outside the allowed range Data None Severity Error Log LOG_INIT Action Set the link speed between 0 and the maximum 0406 Adapter maximum temperatur xceeded lt temperature gt taking this port offline The driver has received an error for the HBA indicating that the maximum allowable temperature has been exceeded Data 1 work_hs 2 work_status 0 3 work_status 1 Severity Error Log LOG_INIT Action Ensure the server fans are not blocked Shut down the server if the airflow is restricted 0407 Ignoring nodev_tmo module parameter because devloss_tmo is set Both module parameters nodev and devloss were set so the driver is ignoring the nodev parameter Data None Severity Error Log LOG_INIT Action Only one of these parameters must be set Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 79 SG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their De
162. ror to Technical Support 0454 Adapter failed to init mbxCmd lt mbxCommand gt INIT_LINK mbxStatus lt mbxStatus gt Adapter initialization failed when issuing an INIT_LINK mailbox command Data None Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support 0456 Adapter failed to issue ASYNCEVT ENABLE mbox status x x The mailbox command to enable an asynchronous event notification failed Data None Severity Error Log LOG_INIT Action Ensure the adapter firmware is current Reload the driver 0457 Adapter Hardware Error The driver received an interrupt indicating a possible hardware issue Data 1 status 2 status1 3 status2 Severity Error Log Always Action This error could indicate a hardware or firmware issue If this issue persists report the error to Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 84 Log Messages gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0458 Bring adapter online The FC driver has received a request to bring the adapter online This may occur when running lputil Data None Severity Warning Log LOG_INIT verbose Action None required 0459 Adapter heartbeat failure taking this port offline The Heartbeat mailbox command failed Data None Severity Erro
163. rotocol LACP when UMC is enabled Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 30 gt EMULEX iSCSI Driver Configuration iSCSI Driver Configuration iSCSI Driver Parameter Descriptions Table 3 4 lists the user configurable iSCSI driver parameters It includes a description of the parameters default values and their configuration value range Note If the value provided for a parameter exceeds the parameter s defined minimum or maximum value the driver logs an error in the event log and continues to load using the parameter s default value Table 3 4 iSCSI Driver Configuration Parameters Parameter Description ETO The Extended Timeout ETO parameter specifies the amount of time in seconds that the initiator driver waits for the target to become available once it has lost the connection to the target during an I O operation The minimum value is 0 The maximum value is 3600 The default value is 30 Note If the ETO value is set between 0 19 the driver assumes a value of 20 internally You will not see any modifications in the registry For more information see Configuring the ETO and LDTO Parameters on page 31 and Error Handling using ETO and LDTO Parameters on page 33 large_io The Large I O large_io parameter specifies the maximum transfer size in a single 1 O request in KBs 1KB 1024 bytes By default the OneConnect iSCSI driver supports up to 128 KB of
164. rt 6 0 1 power uevent Emulex Drivers for Linux User Manual P007633 01B Rev A 3 Configuration 40 gt EMULEX Virtual Port VPort Configuration sys devices pci00 03 00 03 06 1 host5 vport 5 0 0 host6 rport 6 0 2 power target6 0 0 uevent In this example There is a new entry in the fc_vports directory for the VPort vport 5 0 0 The vport 5 0 0 entry indicates that the VPort was created from host5 and it is the first 0 VPort to be created on that fc_host The new host for the VPort is host6 and it will appear in the usual directories There is also a new directory in the bus tree This new directory indicates that host6 was created under vport 5 0 0 which was created from host5 VPort Configuration Limits VPort configuration limits are designated as enforced or unenforced Enforced limits are limits that the driver enforces and prevents the user from exceeding Unenforced limits are limits that the driver cannot enforce but configurations that exceed them are unsupported The following VPort configuration limits have been tested with and are supported by the Emulex driver Configurations that exceed one or more of these limits are unsupported Before the VPort is deleted or the driver is unloaded I O devices accessed through a VPort must be stopped and file systems must be unmounted For enterprise class adapters the maximum number of VPorts configurable on a physical port is 64 The hardware allows more than 6
165. rt command If the fcauthd daemon is not running nothing happens Ipfc_enable_auth Module Parameter Use the lpfc_enable_auth module parameter to enable or disable authentication support This module parameter can be set when the LPFC driver is loaded to enable or disable authentication on all Emulex adapters in the system or it can be set dynamically after the LPFC driver is loaded to enable or disable authentication for each port physical and virtual The default setting for the lpfc enable auth module parameter is disabled See Dynamic FC and FCoE Driver Parameters on page 21 Authentication Configuration Parameters You can configure each port s authentication parameters using the OneCommand Manager application See the latest OneCommand Manager Application User Manual Setting Remote and Local Passwords You can configure each port s password using the OneCommand Manager application See the latest OneCommand Manager Application User Manual Network Performance Tuning The OneConnect UCNA is an x8 Generation 2 Gen2 PCI Express PCle device To obtain the best two port throughput from the OneConnect UCNA it should be installed in an x8 or x16 Gen2 PCle slot Memory Bandwidth Considerations The availability of higher memory bandwidth leads to better network performance The following sections describe how memory bandwidth can be increased Enabling Optimal Bandwidth Options Most computers offer multiple distinct mem
166. rt scope Installing the Ethernet Driver Kit Note Remove any previously installed Ethernet driver kits that were installed from the Emulex website that is those that were not part of a distribution s kernel before proceeding See Uninstalling the Ethernet Driver Kit on page 15 for more information To install the Ethernet driver 1 Download the appropriate driver kit from the Emulex website 2 Log on as root to a terminal and unpack the tarball tar xzf elx be2net dd lt driver version gt tar gz 3 Change to the directory that is extracted cd elx be2net dd lt driver version gt 4 Run the elx_net_install script without options to install the driver kit elx_net_install sh Once the elx_net_install sh script has finished running successfully the Emulex Ethernet driver is loaded and devices that are connected to the system are accessible Reboot the system to enable the newly added driver options in the ramdisk You can also reboot the system later if you want Uninstalling the Ethernet Driver Kit Note You must run the uninstall script that shipped with the version of the driver kit you want to remove To uninstall the Ethernet driver 1 2 Log on as root If possible exit all applications that use Ethernet attached drives then unmount the drives If you cannot exit all applications that use Ethernet attached drives the uninstall works properly but you must reboot after
167. s lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to delete the event queue has failed Data None Severity Error Log LOG_INIT Action None required 2506 CQ DESTROY mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to delete the completion queue has failed Data None Severity Error Log LOG_INIT Action None required 2507 MQ DESTROY mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to delete the mailbox queue has failed Data None Severity Error Log LOG_INIT Action None required 2508 WQ DESTROY mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to delete the work queue has failed Data None Severity Error Log LOG_INIT Action None required 2509 RQ DESTROY mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt The mailbox command sent to delete the work queue has failed Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 118 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Conti
168. s remote port Data DID WWN Severity Error Log Always Action Verify the remote port s configuration If this issue persists report the error to Technical Support Run with verbose mode on for more details 0217 Block sgl registration required DMAsize lt reqlen gt great than a page The request to post SGL pages does not fit on a page Data None Severity Warning Log LOG_INIT Action None required 0221 FAN timeout A link up event was received without the login bit set so the driver waits E_D_TOV for the Fabric to send a FAN If no FAN if received a FLOGI will be sent after the timeout Data None Severity Warning Log LOG_DISCOVERY verbose Action None required The driver recovers from this condition by issuing a FLOGI to the fabric 0222 Initial FLOG FDISKI timeout The driver sent the initial FLOGI or FDISK to the fabric and never got a response back Data None Severity Error Log Always Action Check Fabric configuration The driver recovers from this and continues with device discovery 0223 Timeout while waiting for NameServer login Our login request to the NameServer was not acknowledged within R_A_TOV Data None Severity Error Log Always Action Check the fabric configuration The driver recovers from this and continues with device discovery Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 59 DG EMULEX Log Messages Table 4 4 LPFC Err
169. s still on the node list during driver unload or PCI hotplug removal Data None Severity Error Log LOG_NODE Action None required 0283 Failed to allocate mbox cmd memory Mailbox allocation error Data None Severity Error Log LOG_INIT Action None required 0285 Allocated DMA memory size lt alloclen gt is less than the requested DMA memorysize lt reqlen gt Memory allocation was truncated Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 65 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0286 lpfc_nlp_state_cleanup failed to allocate statistical data buffer lt nlp_ DID gt Memory allocation failed for node s statistical data Data None Severity Error Log LOG_INIT Action None required 0287 lpfc alloc bucket failed to allocate statistical data buffer DID lt nlp_ DID gt 7 7 Memory allocation failed for node s statistical data Data None Severity Error Log LOG_NODE Action None required 0288 Unknown FCoE event type lt event_type gt event tag lt event_tag gt The firmware has detected an unknown FCoE event Data None Severity Error Log LOG_SLI Action Check the FCoE switch configuration and the HBA DCBX mode 0289 Issue Register VFI failed Err lt rc gt The driver could not register th
170. scriptions Continued 0410 Cannot find virtual addr for mapped buf on ring lt ringno gt The driver cannot find the specified buffer in its mapping table Therefore it cannot find the virtual address needed to access the data Data 1 phys 2 next 3 prev 4 postbufq_cnt Severity Error Log Always Action This error could indicate a software driver or firmware issue If this issue persists report these errors to Technical Support 0421 MSI X slow path request_irq failed lt rc gt The kernel API to request an IRQ has failed Data None Severity Warning Log LOG_INIT Action Use module parameter lpfc_use_msi 0 INTX 0422 lpfc_restrict_login attribute cannot be set to lt val gt allowed range is 0 1 Attempt to set the restrict login parameter to something other than on or off Data None Severity Error Log LOG_INIT Action Use 0 Off or 1 On 0423 lpfc_ attr attribute cannot be set to d allowed range is minval maxval This is a compile time macro that is used by several module parameters during initialization Each module parameter has its own minimum and maximum values that are displayed Data None Severity Error Log LOG_INIT Action Set the module parameter between the minimum and maximum values 0424 lpfc attr attribute cannot be set to d allowed range is minval maxval This is a compile time macro that is used by several module parameters to set the v
171. secorebbeceversebheuneseaviasedeasewebstes ndedoaeces net dienes one 29 ISGSI Driver GOnfiGuUratiON cocci cevigineesscees cei wiesesaaiiwdscecceuesndiecciaieaistececeeedaedeees 30 iSCSI Driver Parameter Descriptions 2 eee cece eee cece eee ee eee ee eee eeeeeeneeeaeeee 30 Configuring the iSCSI Driver Parameters ccccecesccceesccccccescccceeeessecensees 31 Configuring the ETO and LDTO Parameters ecceeceeeeeeeee seen nescence eeeeeeeeeeeenes 31 Configuring the large_io Parameter cece eee e seen cence eee e eee eee eeeeeeeeeeeneeeeees 31 Configuring the im_policy Parameter ccecceeee cece nsec sees eee eee eeeeneeeeeeeeeeenes 32 iSCSI Error Handling sass csvin savin hocseweesdtiws tinweeateaiadvitaw lt s eee ee EAEE REE E KE 33 Error Handling using ETO and LDTO Parameters ecceceeecceeeeeeeeeeeeeeeeeeeeees 33 Error Handling Under MultiPath I O MPIO and Cluster Configurations 06 33 Virtual Port VPort Configuration sessesecssseescoossescosscesosesecosseccsssecoesseseoo 34 VPort Configuration Prerequisites sesssesssssossesesessserossssesesseessesrossese 34 Creating Deleting and Displaying VPorts ccccccceessscccceesesceeetccceeeesees 34 Creating VPorts Using the mkvport sh Script ssssssssssesseeseesecceceecseeeeeeeseeeeeese 34 Deleting VPorts Using the rmvport sh Script sssessessssssesssessessssssesssssssssessessees 35
172. status gt mbx The READ_FCF_RECORD mailbox command failed Data None Severity Error Log LOG_INIT Action None required 2523 Allocated DMA memory size lt alloc_len gt is less than the requested DMA memory size lt req len gt The ADD_FCF_RECORD mailbox command failed to retrieve the length required from the firmware Data None Severity Error Log LOG_INIT Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 4 Troubleshooting 120 gt lt EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 2524 Failed to get the non embedded SGE virtual address The READ_FCF_RECORD mailbox command could not retrieve the SGE that was requested Data None Severity Error Log LOG_MBOX Action None required 2527 Failed to allocate non embedded SGE array Failed to allocate the non embedded SGE array Data None Severity Error Log LOG_MBOX Action None required 2528 Mailbox command lt vpi gt cannot issue The mailbox command could not be issued because the mailbox interrupt is disabled Data 1 mbxCommand 2 sli_flag 3 flag Severity Error Log LOG_MBOX LOG_SLI Action None required 2529 Mailbox command lt vpi gt cannot issue Data 1 mbxCommand 2 sli_flag 3 flag Severity Error Log LOG_MBOX LOG_SLI Action None required 2530 Mailbox command lt vpi gt cannot issue The SLI layer
173. t lt Init iatorName gt lt HeaderDigest gt lt DataDigest gt lt AuthenticationType gt e Strings shown in quotes are part of the syntax and are mandatory e Fields enclosed in angular brackets including the angular brackets should be replaced with their corresponding values Some of these fields are optional and may be skipped e Ifan optional field is skipped a colon must be used as a placeholder to indicate the default value for that field e When specified the value of each parameter should be enclosed in double quotes e All options are case sensitive Default Initiator Name and Data Digest Settings Example The following is an example of default initiator name and data digest settings iscsi 192 168 0 2 3261 000000000000000E ign 2009 4 com 12345 67890 Res 2 Re In this example the field values are e TargetIP 192 168 0 2 e TargetTCPPort 3261 e LUN 0x0E e TargetName iqn 2009 04 com 1234567890 Emulex Drivers for Linux User Manual P007633 01B Rev A Appendix B Configuring iSCSI Through DHCP 140 DG EMULEX DHCP Option 43 Vendor Specific Information InitiatorName Not specified Use the Initiator name already configured Use the default name if none was configured HeaderDigest Enabled DataDigest Not specified Assume disabled AuthenticationType One way CHAP is enabled Default TCP and Mutual CHAP Settings Example The following is an exampl
174. t Bootup This failure may be due to the firmware not being present or running currently This failure may also indicate a hardware issue Internal API failed during Initialization This failure may indicate a low memory condition Hardware Initialization Failed Either Hardware Firmware is not initialized or is malfunctioning This failure indicates that the hardware has not been initialized or is malfunctioning This may also indicate that the firmware is not running correctly Please LinkDown Timeout Expired check the Physical Link to OneConnect Check the links to the UCNA If the link is reestablished any sessions that existed previously will be reestablished and the devices will be available for 1 0 OSM Hardware Initialization Failure This failure indicates that the hardware has not been initialized or is malfunctioning This may also indicate that the firmware is not running correctly OSM Resource Allocation Failure The operating system failed to allocate resources for the device Check low memory conditions and operating system hardware resource conflicts Received a TMF Abort for an I O that is not present with the driver This may indicate a slow connection to the target Check network connectivity to the target for any errors Received invalid iSCSI Command Sequence Number update from Target Check for any errors reported at the target The Emulex iSCSI initiator is on
175. t GRO or the LRO mechanism in older Linux driver versions RX frame coalescing is enabled by default In some configurations where the end point for the TCP connection to which the packets belong is not in the current server for example the end point is a router RX coalescing should not be enabled GRO can be disabled using the K option with the ethtool command ethtool K eth lt N gt gro off LRO can be disabled using the C option with the ethtool command ethtool C eth lt N gt rx frames 1 where eth lt N gt is the name of the Ethernet device you are working on for example eth0 Maximum Transmission Unit MTU The OneConnect Ethernet driver supports MTUs between 256 bytes and 9000 bytes The default MTU is set to 1500 If other elements in the network path support a larger MTU you can increase the MTU up to 9000 using the ifconfig command To do this run ifconfig lt ethN gt mtu 9000 where eth lt N gt is the name of the Ethernet device you are working on for example eth0 Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 46 gt lt EMULEX Network Performance Tuning Interrupt Coalescing The OneConnect Ethernet driver tries to reduce the number of interrupts by delaying the interrupts from the UCNA This reduces CPU utilization during a high traffic rate The interrupt delay duration can be set to change dynamically within a range of values depending on the receive rate known as Ad
176. t architectures o CentOS 6 0 and 6 1 Intel x86 Intel EM64T AMD64 and PowerPC 64 bit architectures o OL5 5 5 6 and 5 7 Intel x86 Intel Itanium2 Intel EM64T AMD64 and PowerPC 64 bit architectures o OL6 0 and 6 1 Intel x86 Intel EM64T AMD64 and PowerPC 64 bit architectures o OL5 6 UEK and OL 6 0 UEK Intel x86 architectures o RHEL5 5 5 6 5 7 and 5 8 Intel x86 Intel Itanium2 Intel EM64T AMD64 and PowerPC 64 bit architectures o RHEL 6 x Intel x86 Intel EM64T AMD64 and PowerPC 64 bit architectures o SLES 10 SP3 and SP4 Intel x86 Intel Itanium2 Intel EM64T AMD64 and PowerPC 64 bit architectures o SLES 11 SPx Intel x86 Intel Itanium2 Intel EM64T AMD64 and PowerPC 64 bit architectures Binary RPM FC and FCoE Driver Kit The binary RPM FC and FCoE driver kit contains the following e lt A zipped tar file that includes the driver binary RPMs for a specific driver version and Linux distribution Note Use only officially released Linux distribution kernels The binary RPM packages only support officially released Linux distribution kernels and do not support pre release distribution kernels e Aniinstallation script elx_lpfc_install sh that installs by default the FC and FCoE driver binary RPM that corresponds to the target system s architecture and kernel memory variant e AREADME file that provides a description of the kit structure its contents and distribution support scope e The driv
177. t the memory used by the driver is the same as for a value of 512 If applications issue I O requests that are larger than 512 KB or need more than 128 scatter gather entries the request is split into multiple requests by the driver Manually Setting the large_io Parameter To manually set the large_io parameter type insmod be2iscsi ko large i0 512 Permanently Setting the large_io Parameter To permanently set large_io on every iSCSI boot edit the etc modprobe conf file In the following example note that the lines beginning with alias are added automatically when the driver is installed The lines beginning with options need to be added manually for non default parameters such as large_io Emulex Drivers for Linux User Manual P007633 01B Rev A is 3 Configuration 32 SXG EMULEX iSCSI Driver Configuration alias eth0 tg3 alias scsi_hostadapter ata _ piix alias scsi_hostadapterl usb storage alias scsi _hostadapter2 be2iscsi options be2iscsi eto 0 ldto 0 large io 512 alias ethl be2net alias eth2 be2net After adding the options line save the file and then rebuild initrd Configuring the im_policy Parameter The interrupt moderation policy setting im_policy parameter controls the rate of interrupts for the OneConnect UCNA Table 3 5 defines the available im_policy settings Table 3 5 Interrupt Moderation Policy im_policy Settings im_policy Value Setting Type Description 0 Disabled I
178. ta None Severity Error Log LOG_ELS Action None required 0143 SLI4 Adapter Hardware Error Data lt status0 gt lt statusl gt The HBA has encountered an unrecoverable error Data None Severity Error Log LOG_INIT Action Use hbacmd to retrieve a dump file Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 57 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0144 Not a valid WCQE code lt Completion Code gt The completion queue handler detected an invalid type Data None Severity Error Log LOG_SLI Action None required 0147 Failed to allocate memory for RSCN event Memory could not be allocated to send the RSCN event to the management application Data None Severity Error Log LOG_ELS Action None required 0148 Failed to allocate memory for LOGO event Memory could not be allocated to send the LOGO event to the FC transport Data None Severity Error Log LOG_ELS Action None required 0149 Failed to allocate memory for ELS event Memory could not be allocated to send the ELS event to the FC transport Data None Severity Error Log LOG_ELS Action None required 0154 Authentication not complete Authentication was restarted because the previous authentication did not complete Data None Severity Error Log LOG_DISCOVERY Action Check the switch configuration
179. temperature has reverted to normal range Data Temperature in Celsius Severity Error Log LOG_TEMP verbose Action No action needed informational 0341 Ring lt ringno gt Cannot find buffer for an unsolicited iocb tag lt un ulpWord 3 gt There are no more pre allocated buffers available to handle unsolicited buffers Data None Severity Error Log LOG_SLI Action Ensure this port is not being managed by multiple ports 0342 Ring lt ringno gt Cannot find buffer for an unsolicited iocb tag lt unsli3 sli3Words gt This is a multiple IOCB unsolicited command and sufficient buffer space cannot be allocated for it Data None Severity Error Log LOG_SLI Action None required 0343 Ring lt ringno gt Cannot find buffer for an unsolicited iocb tag lt un ulpWord 3 gt There are no more pre allocated buffers available to handle unsolicited buffers Data None Severity Error Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 71 Log Messages gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0344 Ring lt ringno gt Cannot find buffer for an unsolicited iocb tag lt unsli3 sli3Words 7 gt There are no more pre allocated buffers available to handle unsolicited buffers Data None Severity Error Log LOG_SLI Action None required 0345 Resetting board due to mailbox timeout iocb ta
180. ter is in an error state the fcauthd daemon probably is not running To determine whether fcauthd is running run etc init d fcauthd status To start fcauthd run etc init d fcauthd start If a SAN configuration has 256 targets mapped by the FC and FCoE driver any additional added targets do not get a target ID mapping by the driver and cause target discovery to fail Removing targets or re initializing the link does not solve this issue Unload and reload the driver to reset available target IDs Ensure that the SAN configuration is correct prior to rebooting the driver This clears the driver s consistent binding table and frees target IDs for new target nodes rmmod fails to unload FC and FCoE driver module due to ERROR Module lpfc is in use This message can appear when you attempt to remove the driver and there is a Logical Volume Group dependent on the driver To resolved this situation 1 Make the Logical Volume Group unavailable Type lvchange a N XXXXXXX The xxxxxxx parameter is the Volume Group Name 2 Stop the OneCommand Manager application 3 Stop Device Mapper rmmod of LPFC driver hangs and module reference count is 0 Emulex Drivers for Linux User Manual Due to a small race condition in the kernel it is possible for an rmmod command to hang Issue the rmmod w command If this does not help reboot the computer P007633 01B Rev A gt G EMULEX 4 Troubleshooting 49
181. the IOCB was never called Data 1 timeout 2 timeleft jiffies Severity Error Log Always Action This error could indicate a software driver firmware or hardware issue If this issue persists report the error to Technical Support 0334 Unknown IOCB command Received an unknown IOCB command completion Data 1 type 2 ulpCommand 3 ulpStatus 4 ulploTag 5 ulpContext Severity Error Log Always Action This error could indicate a software driver or firmware issue If this issue persists report these errors to Technical Support Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 70 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0335 Unknown IOCB command Received an unknown IOCB command completion Data 1 ulpCommand 2 ulpStatus 3 ulploTag 4 ulpContext Severity Error Log Always Action This error could indicate a software driver or firmware issue If this issue persists report these errors to Technical Support 0336 Rsp Ring lt ringno gt error IOCB An IOCB error has occurred on the specified ring Data 1 ulpWord 0 2 ulpWord 1 3 ulpWord 2 4 ulpWord 3 5 ulpWord 4 6 ulpWord 5 7 irsp 6 8 irsp 7 Severity Warning Log LOG_SLI verbose Action If this issue persists check the targets If the targets are okay report the error to Technical Support 0340 Adapter temperature is OK now Adapter
182. the name of the ramdisk image to match the SLES naming scheme 2 Update any file links to the ramdisk image 3 Edit the boot loader configuration file for example etc lilo conf etc yaboot conf boot grub grub conf boot grub menu st find any references to the old ramdisk image name and replace them with the new name 4 Reboot the system to verify the changes 5 Install the Emulex LPFC Linux driver kit The Linux SCSI subsystem sees only eight LUNs when more are present Emulex Drivers for Linux User Manual Some SCSI drivers do not scan past eight LUNs when the target reports itself as a SCSI 2 device To resolve this situation force a SCSI bus scan with the following command usr sbin lpfc lun_scan SUSE supplies a bin rescan scsi bus sh script which can be changed to scan everything P007633 01B Rev A gt G EMULEX 4 Troubleshooting 52 Situations and their Resolutions Ethernet Driver Situations and their Resolutions Table 4 2 lists the Ethernet Driver situations and their resolutions for the OneConnect UCNA Table 4 2 Ethernet Driver Situations and their Resolutions Situation The Ethernet driver works but the transmit and receive data rates are not near a 10 Gb s line rate Resolution There could be several reasons for poor performance The driver logs a warning message if the card is found in a suboptimal slot If you see this message in var log messages move the card
183. the uninstallation is complete Run the elx_net_install sh script with the uninstall option elx net _install sh uninstall Emulex Drivers for Linux User Manual P007633 01B Rev A ys is 2 Installing and Uninstalling 16 gt C EMULEX iSCSI Driver Kit iSCSI Driver Kit The iSCSI driver kit includes the driver that supports the iSCSI protocol The iSCSI driver kit contains the following e A zipped tar file that includes the binary RPMs for a specific driver version and for all of the supported Linux distribution kernels Note Use only officially released Linux distribution kernels The binary RPM packages only support officially released Linux distribution kernels and do not support pre release distribution kernels e An installation script elx_iscsi_install sh that installs by default the iSCSI driver binary RPM that corresponds to the target system s architecture and kernel memory variant e A README file that provides a description of the kit structure its contents and distribution support Installing the iSCSI Driver Kit Note Remove any previously installed iSCSI driver kits and or Application Helper Modules that were installed from the Emulex website that is those that were not part of a distribution s kernel before proceeding See Uninstalling the iSCSI Driver Kit on page 16 for more information To install the iSCSI driver 1 Download the appropriate driver kit from the Emulex website 2
184. tion 27 scsi_id g s sys class scsi_generic sg0 350060b000029b592 The value returned has a leading prefix of 3 which is the NAA type The remaining digits represent the FC controller s WWPN The following is an FC tape device example using the SCSI tape driver The value returned is the same as the previous example scsi_id g s sys class scsi_tape nst0 350060b000029b592 In both examples g was needed because the vendor and model for this tape device were not in the etc scsi_id config file The following is an example for a different FC tape vendor Notice that the value returned is similar to the previous examples with respect to the leading digit and the WWPN sbin scsi_id g s sys class scsi_tape nst0 35005076300015101 FC SCSI Tape Device Example The following is an example of a FC controller with multiple SCSI tape devices behind it FC SCSI tape device When the Emulex driver is loaded the SCSI mid level discovers the SCSI tape devices as follows scsi scan INQUIRY to host 14 channel 0 id O lun 0 scsi unknown device type 12 Vendor ADIC Model SNC 4000 Rev 42d4 Type RAID ANSI SCSI revision 03 Attached scsi generic sg5 at scsil4 channel 0 id 0 lun 0 type 12 scsi scan INQUIRY to host 14 channel 0 id O lun 1 Vendor ADIC Model Scalar 24 Rev 227A Type Medium Changer ANSI SCSI revision 02 Attached scsi generic sg6 at scsil4 channel 0 id 0 lun 1 type 8 scsi scan INQUIRY to
185. tions Continued 0485 MSI X slow path request_irg failed lt rc gt The request_irq kernel API has failed Data None Severity Warning Log LOG_INIT Action Set module parameter lpfc_use_msi 0 0486 MSI X fast path lt index gt request _irq failed lt rc gt The request_irq kernel API has failed Data None Severity Warning Log LOG_INIT Action Set module parameter lpfc_use_msi 0 0490 MSI request_irg failed lt rc gt The request_irq kernel API has failed Data None Severity Warning Log LOG_INIT Action Set module parameter lpfc_use_msi 0 0492 Unable to allocate memory for issuing SLI CONFIG SPECIAL mailbox command Mailbox memory pool allocation error Data None Severity Error Log LOG_INIT Action None required 0493 SLI _ CONFIG SPECIAL mailbox failed with status lt rc gt Mailbox command failed Data None Severity Error Log LOG_INIT Action Ensure the adapter s firmware is current Unload and reload the driver 0494 Unable to allocate memory for issuing SLI FUNCTION RESET mailbox command Mailbox memory pool allocation error Data None Severity Error Log LOG_INIT Action None required 0495 SLI FUNCTION RESET mailbox failed with status lt shdr_status gt add status lt shdr_add_status gt mbx status lt rc gt Mailbox command failed Data None Severity Error Log LOG_INIT Action Reset the
186. to the proper slot For best performance practices see Network Performance Tuning on page 42 ethtool configuration settings are not restored after system reboot ethtool settings are not designed to persist across reboot For persistence configuration commands should be invoked from a boot script that is executed at system start such as etc rc local When MILI and SNMP daemons start they trigger warning messages within SELinux for certain operations Emulex Drivers for Linux User Manual This is a known issue and there is no solution However to avoid SElinux warning messages you can disable SELinux To disable SELinux open a terminal and enter the following command at the prompt echo 0 gt selinux enforc To enable SELinux use the following command echo 1 gt selinux enforc Also see Analyzing Performance Issues on page 47 P007633 01B Rev A 4 Troubleshooting 53 Situations and their Resolutions gt G EMULEX iSCSI Driver Situations and their Resolutions Table 4 3 lists the iSCSI driver situations and their resolutions for the OneConnect UCNA Table 4 3 iSCSI Driver Situations and their Resolutions Situation When you log out of a target while an 1 0 is running and you log into the target again you will get an error trace in var log messages beginning with the error message trying to free buffer Resolution There is no solution to this issue
187. ual P007633 01B Rev A is 3 Configuration 36 SXG EMULEX Virtual Port VPort Configuration fc_host host8 host10 power scsi_host host8 uevent ls sys bus pci drivers 1lpfc 0000 07 00 0 host8 host10 fc_host host10 power scsi_host host10 uevent In this example host 8 is the physical port and host 10 is a VPort that was created on host 8 For FC 8 3 5 x Drivers When a VPort is created three new directories are created in the class tree sys class scsi_host hostY sys class fc_host hostY sys class fc_vports vport X 0 2 Creating a new VPort also creates a new sysfs directory in the bus and devices tree sys bus pci drivers lpfc 0000 A B C hostX vport X 0 Z hosty sys devices pci0000 A 0000 A B C hostX vport X 0 Z hostY In both directories there is a hostY directory that contains the remote ports that this new host can access sys bus pci drivers lpfc 0000 A B C hostX vport X 0 Z hosty sys bus pci drivers lpfc 0000 A B C hostX vport X 0 Z hostY rport Y 0 0 sys bus pci drivers lpfc 0000 A B C hostX vport X 0 Z hostY rport Y 0 1 sys bus pci drivers lpfc 0000 A B C hostX vport X 0 Z hostY rport Y 0 2 In this example e Y indicates the new host value for the VPort that was created e X indicates the host value for the parent fc_host that this VPort was created from e Z indicates the instance of VPort created from the parent fc_host A B and C indicate the PCI hierarchy for each physical LPFC port
188. upport 0310 Mailbox command lt mbxcommand gt timeout A mailbox command was posted to the adapter and did not complete within 30 seconds Data 1 hba_state 2 sli_flag 3 mbox_active Severity Error Log Always Action This error could indicate a software driver or firmware issue If no I O is going through the adapter reboot the system If this issue persists report the error to Technical Support 0312 Ring lt ringno gt handler portRspPut lt rspPutInx gt is bigger then rsp ring lt numRiocb gt The IOCB command rings put pointer is ahead of the get pointer Data None Severity Error Log LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 68 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0313 Ring lt ringno gt handler unexpected Rctl lt Rctl gt Type lt Type gt received The RCTL Type of a received frame did not match any for the configured masks for the specified ring Data None Severity Warning Log LOG_SLI verbose Action This error could indicate a software driver firmware or hardware issue Report these errors to Technical Support 0315 Ring lt ringno gt issue portCmdGet lt local getidx gt is bigger then cmd ring lt max_cmd_idx gt The port command ring get index is greater than the size of the command ring Data None Severity Error Log Always Action This error c
189. ution that is supported Driver Distribution Driver Version Inbox DUP DUD Out of Box Supported Operating Systems FC and FCoE Drivers 8 2 0 127 v CentOS 5 6 and later OL 5 6 and later RHEL 5 6 and later SLES 10 SP3 and later 8 2 0 128 v CentOS 5 6 and later OL 5 6 and later RHEL 5 6 and later SLES 10 SP3 and later 8 2 0 128 1p v CentOS 5 6 and later OL 5 6 and later RHEL 5 6 and later SLES 10 SP3 and later 8 2 0 134 v CentOS 5 6 and later OL 5 6 and later RHEL 5 6 and later SLES 10 SP3 and later 8 3 5 66 v CentOS 6 0 and later OL 6 0 and later OL 5 6 UEK OL 6 0 UEK RHEL 6 0 and later SLES 11 SP1 and later 8 3 5 68 v CentOS 6 0 and later OL 6 0 and later OL 5 6 UEK OL 6 0 UEK RHEL 6 0 and later SLES 11 SP1 and later 8 3 5 68 1p v CentOS 6 0 and later OL 6 0 and later OL 5 6 UEK OL 6 0 UEK RHEL 6 0 and later SLES 11 SP1 and later 8 3 5 74 v CentOS 6 0 and later OL 6 0 and later OL 5 6 UEK OL 6 0 UEK RHEL 6 0 and later SLES 11 SP1 and later XenServer 5 6 and later XenServer 6 0 and later Ethernet Drivers 4 1 334 34 v RHEL 5 6 RHEL 5 7 RHEL 6 0 and later SLES 10 SP3 and later SLES 11 SP1 4 1 334 39 RHEL 5 8 SLES 11 SP2 4 1 402 6 v RHEL 5 6 and later RHEL 6 0 and later SLES 10 SP3 and later SLES 11 SP1 and later 4 1 413 0 v RHEL 5 6 and later RHEL 6 0 and later SLES 10 SP3 and later SLES 11 SP1 and later XenServer 5 6 XenServer 6
190. verbose Oxffffffftt If the same option is specified in both the etc modprobe conf and on the modprobe command line the option setting in the command line takes precedence Configure Parameters with a Read Write to sysfs Sysfs is a virtual file system that exposes the structure of the system It also includes interfaces to driver parameters through which the FC and FCoE driver parameters can be viewed and modified Since these interfaces are available only after driver load only dynamic FC and FCoE driver parameters can be changed However both static and dynamic FC and FCoE driver parameters can be read through sysfs Note Sysfs changes exist only during driver load and are lost when the FC and FCoE driver is unloaded or the system is rebooted Viewing Parameters with sysfs The sysfs file system is mounted and available as sys You must first identify the scsi_host that represents the adapter for which you want to modify the FC and FCoE driver parameters All scsi_hosts bound to the FC and FCoE driver can be viewed with the following command ls d sys bus pci drivers lpfc host Assuming you are interested in adapter scsi_host 7 you can list the FC and FCoE driver parameters for this particular adapter as ls 1 sys class scsi_host host7 lpfc An example output follows r r r 1 root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc_ack0O r r r 1 root root 4096 Feb 28 17 03 sys class scsi_host host7 lpfc
191. word2 hex gt lt req_ ftr word3 hex gt lt cfg_enable npiv gt lt max vpi hex gt The features passed in to the driver as module parameters do not match what the firmware can do Setting to default values Data None Severity Warning Log LOG_MBOX LOG_SLI Action None required 0381 Error d during queue setup Could not set up all the queues that the driver requires to exchange I Os with the HBA Data None Severity Error Log LOG_MBOX LOG_SLI Action Reload the driver 0382 READ SPARAM command failed status lt issue status gt mbxStatus lt mailbox status gt The READ_SPARAM mailbox command has failed during initialization The HBA has been set to error state Data None Severity Error Log LOG_MBOX LOG_SLI Action Take a dump with hbacmd and then try reloading the driver 0383 Error lt rc gt during scsi sgl post operation The SGL entries could not be registered with the adapter Data None Severity Warning Log LOG_MBOX LOG_SLI Action Reset the adapter using hbacmd 0384 There is pending active mailbox cmd The mailbox commands have overlapped This command should have been added to the mailbox queue Data None Severity Error Log LOG_MBOX LOG_SLI Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A is 4 Troubleshooting 76 DG EMULEX Log Messages Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0385 r
192. x_frag_size module parameter The driver ignores the Using 2048 specified value and uses the default RX buffer size of 2048 MSIX request IRQ failed The request for MSI X interrupt registration failed The Warning err lt DDD gt Emulex Drivers for Linux User Manual driver will use INTx interrupts P007633 01B Rev A gt G EMULEX Log Messages 4 Troubleshooting 133 Table 4 5 Ethernet Driver Log Messages of Type Continued Ethernet Log Message Description Type MTU changed from lt DDD gt to This is an informational message that the MTU value Information lt DDD gt changed as requested MTU must be between 256 Request to change the MTU was issued with an invalid Warning and 9000 bytes MTU value The request failed and MTU will not be changed OneConnect card in a The driver found a OneConnect UCNA in a PCle slot Warning Gen lt D gt x lt D gt PCIe slot It that is Gen1 or less than x8 wide The UCNA will should be in a Gen2 x8 slot continue to work but will not provide the best for best performance performance Pause param set failed The firmware command to set pause frame settings Warning failed POST failed The power on self test of the UCNA failed This isan Error indication of a hardware or firmware issue Try rebooting the system after a reset Emulex Drivers for Linux User Manual P007633 01B Rev A gt G EMULEX iSCSI Driver Log Messages 4 Troubleshooting 134 Log M
193. y Warning Log LOG_NODE Action None required 0277 lpfc_enable node ndlp x spusgmap x x refcnt d void ndlp ndlp gt nlp_usg map atomic _read amp ndlp gt kref refcount Enable node was attempted on an inactive node Data None Severity Warning Log LOG_NODE Action None required Emulex Drivers for Linux User Manual P007633 01B Rev A 4 Troubleshooting 64 Log Messages gt G EMULEX Table 4 4 LPFC Error Log Messages and their Descriptions Continued 0278 lpfc_enable node ndlp x spusgmap x x refcnt d void ndlp ndlp gt nlp_usg map atomic _read amp ndlp gt kref refcount Enable node was attempted on an inactive node Data None Severity Warning Log LOG_NODE Action None required 0280 lpfc_cleanup_node ndlp x spusgmap x x refcnt d void ndlp ndlp gt nlp_usg map atomic _read amp ndlp gt kref refcount Node clean up was attempted on a node that has already been marked for memory free Data None Severity Warning Log LOG_NODE Action None required 0281 lpfc_cleanup_node ndlp xspusgmap x x refcnt d void ndlp ndlp gt nlp_usg_map atomic_read amp ndlp gt kref refcount Node clean up was called to prepare the node for release Data None Severity Warning Log LOG_NODE Action None required 0282 ldid x sx ndlp xspusgmap x x refcnt d ndlp gt nlp DID void ndlp lpfc_init c ndlp gt nlp usg_ map Driver clean up has found a node that i

Emulex® Drivers for Linux User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents

Emulex&reg; Drivers for Linux User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents

Emulex® Drivers for Linux User Manual