Home

Emulex Drivers for Solaris User Manual

1. MSG ID 0822 DEBUG ELS reply VERBOSE MASK LOG ELS 0x00000100 DESCRIPTION A reply is being sent for an unsolicited ELS command S M EVERITY LEVEL Debug ESSAGE ELS reply ACTION No action needed MSG_ID 0830 ERROR Invalid ELS command found ERBOSE MASK LOG ELS 0x00000100 V DESCRIPTION The ELS command was found with an invalid command code SEVERITY LEVEL Error MESSAGE Invalid ELS command found ACTION No action needed If problems persist report these errors to Emulex technical support General I O Packet Events MSG_ID 0900 NOTICE Packet abort VERBOSE MASK LOG PKT 0x00000200 DESCRIPTION An I O packet is being aborted Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emixs Logs 64 DG EMULEX Messages SEVERITY LEVEL Notice MESSAGE Packet abort ACTION No action needed MSG_ID 0901 WARNING Packet abort failed VERBOSE MASK LOG PKT 0x00000200 DESCRIPTION An attempt to abort an I O packet has failed SEVERITY LEVEL Warning MESSAGE Packet abort failed ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0910 DEBUG Packet timeout VERBOSE MASK LOG PKT 0x00000200
2. MSG_ID 0501 DEBUG Mailbox detail ERBOSE MASK LOG MBOX DETAIL 0x40000000 V DESCRIPTION This message provides detailed information about a mailbox event S M EVERITY LEVEL Debug ESSAGE Mailbox detail ACTION No action needed MSG_ID 0510 DEBUG Stray mailbox interrupt ERBOSE MASK LOG MBOX 0x00000020 V DESCRIPTION A mailbox command completion interrupt was received and the mailbox is not valid This error may indicate a driver or firmware problem S M EVERITY LEVEL Debug ESSAGE Stray mailbox interrupt ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0520 DEBUG Mailbox error ERBOSE MASK LOG MBOX 0x00000020 V DESCRIPTION An unsupported or illegal mailbox command was completed This error may indicate a driver or firmware problem S M EVERITY LEVEL Debug ESSAGE Mailbox error ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ ID 0530 ERROR Mailbox timeout ERBOSE MASK LOG MBOX 0x00000020 V DESCRIPTION The firmware did not response a mailbox command This error may indicate a hardware or firmware problem S M EVERITY LEVEL Error ESSAGE Mailbox timeout
3. ESSAGE Stray ELS completion ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0811 DEBUG Abnormal ELS completion VERBOSE MASK LOG ELS 0x00000100 DESCRIPTION The ELS command completed with a status error in the IOCB The FC device on the network may not be responding or the FC device is not an FCP target The driver automatically retries this ELS command if needed SEVERITY LEVEL Debug MESSAGE Abnormal ELS completion Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs gt lt EMULEX oo ACTION If the command is a PLOGI or PRLI and the destination PortID is not an FCP Target no action is needed Otherwise check the physical connections to the FC network and check the state of the remote PortID MSG_ID 0820 DEBUG ELS rcvd ERBOSE MASK LOG ELS 0x00000100 V DESCRIPTION An unsolicited ELS command was received 5 M EVERITY LEVEL Debug ESSAGE ELS rcvd ACTION No action needed MSG_ID 0821 DEBUG Unsolicited ELS dropped VERBOSE MASK LOG ELS 0x00000100 DESCRIPTION An unsolicited ELS command was received and then dropped S M EVERITY LEVEL Debug ESSAGE Unsolicited ELS dropped ACTION No action needed
4. MSG ID 1801 DEBUG FCF detail Emulex Drivers for Solaris FC and FCoE version 2 70i 8 emixs Logs 77 Messages V DESCRIPTION Authentication is being started to a specific node S M ESCRIPTION Authentication is being stopped or completed to a specific ESCRIPTION This message provides general information about the P009212 01A Rev A 8 emlxs Logs gt lt EMULEX PE ERBOSE MASK V DESCRIPTION This message provides detailed information about the driver s FCF interface S M EVERITY LEVEL Debug ESSAGE FCF detail ACTION No action needed MSG_ID 1810 DEBUG FCF error ERBOSE MASK EVERITY LEVEL Debug ESSAGE FCF error ACTION No action needed V DESCRIPTION An error was found while processing an FCF request S M MSG_ID 1820 DEBUG FCF state VERBOSE MASK DESCRIPTION An FCF object state is changing S M EVERITY LEVEL Debug ESSAGE FCF state ACTION No action needed MSG_ID 1820 DEBUG FCF event VERBOSE MASK DESCRIPTION An FCF event has occurred S M EVERITY LEVEL Debug ESSAGE FCF event ACTION No action needed Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX 9 oce Logs 9 oce Logs 79 Messages The logs are generated based on the MOD_MASK and Severity
5. MSG ID 1411 DEBUG DFC detail ERBOSE MASK LOG IOCTL DETAIL 0x04000000 V DESCRIPTION This message provides detailed information about the driver s DFC interface S M EVERITY LEVEL Debug ESSAGE DFC detail ACTION No action needed MSG ID 1420 DEBUG DFC Error VERBOSE MASK LOG IOCTL 0x00004000 DESCRIPTION An error was found while processing a DFC request SEVERITY LEVEL Debug Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs 72 DG EMULEX Messages MESSAG E DFC error ACTION No action needed Firmware Download Events MSG ID 1500 DEBUG Firmware image ERBOS E MASK LOG FIRMWARE 0x00008000 ESCRI EV PTION This message provides general information about the V D firmware image S M ERITY LEVEL Debug ESSAG E Firmware image ACTION No action needed MSG _ ID 1501 DEBUG Firmware detail ERBOS ESCRI EV E MASK LOG FIRMWARE DETAIL 0x10000000 PTION This message provides detailed information about the ERITY LEVEL Debug V D firmware image S M ESSAG E Firmware detail ACTION No action needed MSG_ ID 1502 NOTICE Firmware Library ERBOS Gl R 0x00000002 ESCRI EVERI E MA
6. VERBOSE MASK LOG_IP 0x00001000 DESCRIPTION An IP sequence was found with an invalid code SEVERITY LEVEL Error Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 Ixs L gt lt EMULEX eo MESSAGE Invalid IP sequence found ACTION No action needed If problems persist report these errors to Emulex technical support Solaris SFS Events MSG ID 1300 DEBUG SFS ERBOSE MASK LOG SFS 0x00002000 V DESCRIPTION This message provides general information about the driver s SFS interface S M EVERITY LEVEL Debug ESSAGE SFS ACTION No action needed MSG_ID 1301 DEBUG SFS detail ERBOSE MASK LOG SFS_DETAIL 0x20000000 V DESCRIPTION This message provides detailed information about the driver s SFS interface S M EVERITY LEVEL Debug ESSAGE SFS detail ACTION No action needed MSG _ ID 1310 WARNING Diagnostic error ERBOSE MASK LOG SFS 0x00002000 V DESCRIPTION A diagnostic request did not complete because of some issue S M EVERITY LEVEL Warning ESSAGE Diagnostic error ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 1311 DEBUG ECHO diagnostic completed VERBOSE MASK LOG SFS 0x00002000 DESCRIPTION
7. MSG_ID 0453 DEBUG IOCB stale ERBOSE MASK LOG SLI 0x00000010 EVERITY LEVEL Debug ESSAGE IOCB stale ACTION No action needed MSG_ID 0460 DEBUG SLI detail ERBOSE_MASK LOG SLI DETAIL 0x80000000 EVERITY LEVEL Debug ESSAGE SLI detail ACTION No action needed V D event S M MSG_ID 0461 ERROR SLI ERROR ERBOSE MASK LOG SLI 0x00000010 EVERITY LEVEL Error ESSAGE SLI ERROR ACTION No action needed V D event S M MSG_ID 0421 DEBUG SLI DEBUG ERBOSE MASK LOG SLI 0x00000010 EVERITY LEVEL Debug ESSAGE SLI DEBUG ACTION No action needed V D event 5 M Mailbox Events MSG_ID 0500 DEBUG Mailbox event VERBOSE MASK LOG MBOX 0x00000020 Emulex Drivers for Solaris FC and FCoE version 2 70i 8 emlxs Logs 57 Messages V DESCRIPTION An IOCB completed after its associated packet completed S M ESCRIPTION This message provides detailed information about an SLI ESCRIPTION This message provides error information about an SLI ESCRIPTION This message provides debug information about an SLI P009212 01A Rev A 8 emlxs Logs DG EMULEX Serene 58 DESCRIPTION A mailbox event has occurred SEVERITY LEVEL Debug MESSAGE Mailbox event ACTION No action needed
8. Uninstalling the Utilities Package Manually To uninstall the emlxu utilities package 1 Uninstall the EMLXemlxu utilities package by typing pkgrm EMLXemlxu You are prompted to confirm the removal by the following message Do you want to remove this package y n q 2 Enter lt y gt The package is prepared for removal and you are prompted again for confirmation Do you want to remove this package y n q 3 Enter lt y gt The following message is displayed Removal of lt EMLXemlxu gt was successful For additional information on installing and uninstalling packages refer to the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manual pages Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 4 FC FCoE Configuration 25 gt G EMULEX Introduction 4 FC FCoE Configuration Introduction emlxs is the module name for the Emulex SFS FCA driver You can configure the Emulex SFS FCA driver properties by e Editing the emlxs conf file which is described in this section e Using the OneCommand Manager application Refer to the OneCommand Manager Application User Manual for more information e Using the Emulex FCA utilities Refer to the Solaris FCA Utilities User Manual for more information If the Emulex LPFC driver for Solaris is already installed you can migrate to the emlxs driver either by customizing and running the unsupported sample scripts
9. 2 1522 ERBOS T E MASK LOG FIRMWARE EVERITY LEVEL PTION An attempt to LErOL V DESCRI S M ESSAG E Firmware download ACTION these errors to Check your hardware configuration Emulex technical support E Firmware download 0x00008000 E Firmware image not compatible support Firmware download 0x00008000 8 emlxs Logs 73 Messages V D The firmware image provided was not compatible with the existing hardware S M report these download a firmware image has occurred 0x00008000 Firmware download complete download a firmware image was successful complete 0x00008000 download a firmwar failed Firmware updated 0x00008000 ERROR Firmware download failed image failed If problems persist report PTION New firmware has been updated on the adapter ACTION A reboot or adapter power cycle is required to activate the new MSG_ID 1523 WARNING VERBOSE MASK LOG FIRMWARE DESCRI SEVERITY LEVEL Warning MESSAGE Firmware updated firmware MSG_ID 1530 DEBUG Emulex Drivers for Solaris FC and FCoE version 2 70i Firmware dump P009212 01A Rev A DG EMULEX ERBOSE MASK LOG FIRMWARE 0x00008000 EVERITY LEVEL Debug ACTION Check MSG_ID 1540 WARNING Firmware update required ERBOSE MAS
10. DESCRIPTION An I O packet has timed out and is being aborted S M EVERITY LEVEL Debug ESSAGE Packet timeout ACTION No action needed MSG ID 0911 DEBUG CHANNEL watchdog ERBOSE MASK LOG_PKT 0x00000200 V DESCRIPTION I O s are getting stale waiting on a I O channel transmit queue S M EVERITY LEVEL Debug ESSAGE CHANNEL watchdog ACTION No action needed MSG_ID 0912 DEBUG TXQ watchdog VERBOSE MASK LOG PKT 0x00000200 DESCRIPTION An I O was found missing from the transmit queue S M EVERITY LEVEL Debug ESSAGE TXQ watchdog ACTION No action needed MSG_ID 0920 DEBUG Packet flush VERBOSE MASK LOG PKT 0x00000200 DESCRIPTION An I O packet is being flushed Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs gt lt EMULEX eo SEVERITY LEVEL Debug MESSAGE Packet flush ACTION No action needed MSG_ID 0921 DEBUG Packet flushed VERBOSE MASK LOG PKT 0x00000200 DESCRIPTION An I O packet has been flushed S M EVERITY LEVEL Debug ESSAGE Packet flushed ACTION No action needed MSG_ID 0922 NOTICE Packet flush timeout ERBOSE MASK LOG_PKT 0x00000200 V DESCRIPTION An I O packet flush request has timed ou
11. For a list of adapters that are compatible with the emlxs and oce driver see the driver s Downloads page on the Emulex website For compatible firmware versions see the Downloads page for the specific adapter Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A gt E EMULEX 3 Installation 16 Installing the Driver 3 Installation Installing the Driver Downloading and Installing the Driver for Solaris 11 1 SPARC x64 The Solaris SFS FCA emlxs driver and the Solaris OneConnect UCNA oce driver are distributed by Oracle as part of the Solaris 11 1 operating environment with driver updates distributed as part of Solaris updates and packages If the Solaris SFS FCA emlxs driver and the Solaris OneConnect UCNA NIC oce driver are not already installed obtain and install the Solaris 11 1 package To obtain and install the Solaris packages 1 Select and download the driver package from the Oracle website 2 Select and download the readme file and follow its instructions To finish the installation or if the Solaris SFS FCA driver the Solaris OneConnect UCNA NIC oce driver was already installed install the driver by obtaining and installing individual packages 1 From the Oracle website download the following required packages e For Solaris 11 1 x64 systems NIC protocol refer to the Oracle website e For Solaris 11 1 SPARC NIC protocol refer to the Oracle website e For Solaris 11 1 x64 systems
12. 3 Run the install script Type wsinstall 4 When prompted enter the Web server s document root directory For example var apache htdocs 5 You are provided with the IP address of the host and asked if that is the IP address that the Web server uses Answer lt y gt or lt n gt as appropriate If you answer lt n gt you are prompted for the IP address you want to use 6 You are asked if your web server is listening on the normal default HTTP port 80 Answer lt y gt or lt n gt as appropriate If you answer lt n gt you are prompted for the port you want to use Once you have entered the necessary information you are notified when the installation of the OneCommand Manager application Web Launch package is complete The Web Launch configuration files are created and Web Launch Service automatically starts 7 To verify the installation locate another client open a Web browser window and enter this URL according to this format http IP_ADDR PORT_NUM ocmanager jnlp where IP_ADDR is the IP address of the host on which you installed the OneCommand Manager application Web Launch service and PORT_NUM is the TCP port number of the listening host s Web server The standard OneCommand Manager application user interface is displayed Note It is not necessary to enter a port number if the standard HTTP port was chosen during configuration Installing or Updating the Utilities Package Manually Compatibility See the
13. MSG_ID 0940 DEBUG Packet completion error EVERITY L ERBOSE MASK LOG PKT 0x00000200 ESCRIPTION An I O packet was completed with an error status This can EV EL Debug ESSAGE Pac ACTION No action needed If problems persist report these errors to Emulex technical support V D occur during normal operation S M ket completion error FCP Traffic Events MSG ID 1000 DEBUG Stray FCP completion EVERITY L ERBOSE MASK LOG_FCP 0x00000400 ESCRIPTION An FCP command completion was received without issuing a orresponding FCP Command This error may indicate a driver or firmware EV EL Debug V D c problem S M ESSAGE S EVERITY L tray FCP completion ACTION No action needed If problems persist report these errors to Emulex technical support MSG ID 1001 DEBUG FCP completion error ERBOSE MASK LOG_FCP 0x00000400 ESCRIPTION An FCP command completed with an error status These occur during normal operation EV V D errors can S M EL Debug ESSAGE FCP completion error ACTION No action needed FCT Traffic Events MSG_ID 1100 DEBUG FCT detail VERBOSE MASK LOG FCT DETAIL 0x00800000 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs gt lt EMULEX oo DE
14. OxFFFFFFFF Dynamic Verbose mask for warning messages to the messages file log errors OxFFFFFFFF 0x00000000 Emulex Drivers for Solaris FC and FCoE version 2 70i OxFFFFFFFF Dynamic Verbose mask for error messages to the messages file P009212 01A Rev A gt EMULEX Table 5 1 emlxs conf Parameters Continued 5 Emulex SFS FCA Driver Properties 29 The Configuration File emlxs conf Property Name Default Min Max Activation Comments max xfer size 339968 131072 1388544 Reboot This property sets the maximum SCSI transfer size in bytes per I O This property is only used by the driver on i386 platforms The driver does not limit transfer size on SPARC platforms This property determines the scatter gather list buffer size A pool of buffers is reallocated by the driver during boot A larger transfer size requires a larger memory allocation Memory_model max xfer size Small 131072 339968 Medium 339969 688128 Large 688129 1388544 network on Reboot Enables disables IP networking support in the driver num iocbs 1024 128 10240 Adapter reset This property indicates the number of Input Output Control Block IOCB buffers to allocate num nodes 4096 Adapter reset The number of FC nodes NPorts the driver supports pci max read 2048 512 4096 Adapter reset This property sets the PCI X
15. 2 pt to pt only 0x2 pt to pt only protocol not 4 loop only 0x4 loop only physical topology 6 pt to pt if it fails attempt Default 0 attempted by the loop Description Controls the driver Default 0 FC topology expected by Description Link topology for LPFC at boot time FC initializing the FC connection offers pt to pt fabric and Set to pt to pt if you want to arbitrated loop For the run as an N_Port Set to loop if adapter to operate as an you want to run as an NL_Port N_Port select pt to pt mode for N_Port to F_Port and N_Port to N_Port connections For the adapter to operate as an NL_Port select loop mode for private loop and public loop topologies The driver rejects an attempt to set the topology to a value not in the above list The auto topology settings 0 and 6 do not work unless the adapter is using firmware version 3 20 or higher ub bufs Min 40 N A N A Max 16320 Default 1000 Description Sets the number of unsolicited buffers to be allocated Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A gt EMULEX 8 emlxs Logs General Situations If an FC link fails to come up verify that an 8 Gb s adapter is not attempting to connect to a 1 Gb s device Only 2 Gb s 4 Gb s and 8 Gb s devices are supported on 8 Gb s adapters Messages 8 emlxsLogs 43 General Situations This section describes the type of console and log messages you may see Securit
16. ERBOSE MASK LOG SLI 0x00000010 V DESCRIPTION A recoverable adapter error has occurred S M EVERITY LEVEL Error ESSAGE Adapter error ACTION This error usually indicates a hardware or firmware problem with the adapter Check and or update firmware levels Report these errors to Emulex technical support MSG_ID 0426 NOTICE Adapter Async Status ERBOSE MASK LOG SLI 0x00000010 V DESCRIPTION The adapter has provided general information about the adapter s async status S M EVERITY LEVEL Notice ESSAGE Adapter Async Status ACTION No action needed MSG_ID 0430 DEBUG Ring event VERBOSE MASK LOG SLI 0x00000010 DESCRIPTION An SLI ring event has occurred S M EVERITY LEVEL Debug ESSAGE Ring event ACTION No action needed MSG_ID 0431 DEBUG Ring error VERBOSE MASK LOG SLI 0x00000010 DESCRIPTION An SLI ring error is being reported by the adapter S M EVERITY LEVEL Debug ESSAGE Ring error Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX ACTION MSG_ID No action needed 0432 DEBUG Ring reset ERBOS EVERI E MASK LOG SLI 0x00000010 PTION An SLI ring is being reset V DESCRI S M TY LEVEL Debug ESSAG ACTION
17. An ECHO diagnostic has completed S M EVERITY LEVEL Debug ESSAGE ECHO diagnostic completed ACTION No action needed MSG_ID 1312 WARNING ECHO diagnostic failed Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 xs L E EMULEX e ERBOSE MASK LOG SFS 0x00002000 V DESCRIPTION An ECHO diagnostic has failed to return a positive result This may indicate a connectivity problem with your FC network S M EVERITY LEVEL Warning ESSAGE ECHO diagnostic failed ACTION Check your network connections If problems persist report these errors to your system administrator MSG_ID 1313 DEBUG BIU diagnostic completed VERBOSE MASK LOG SFS 0x00002000 DESCRIPTION A BIU diagnostic has completed S M EVERITY LEVEL Debug ESSAGE BIU diagnostic completed ACTION No action needed MSG_ID 1314 ERROR BIU diagnostic failed ERBOSE MASK LOG SFS 0x00002000 V DESCRIPTION A BIU diagnostic has failed to return a positive result This is usually caused by an adapter hardware problem S M EVERITY LEVEL Error ESSAGE BIU diagnostic failed ACTION Contact Emulex technical support MSG_ID 1315 DEBUG POST diagnostic completed VERBOSE MASK LOG SFS 0x00002000 DESCRIPTION A POST diagnostic has completed
18. Debug V DESCRIPTION A node has been destroyed for a remote device S M ESSAGE Node destroy Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX 8 emlxs Logs 60 Messages ACTION No action needed MSG_ID 0611 DEBUG Node closed VERBOSE MASK LOG NODE DETAIL 0x02000000 DESCRIPTION A node has been temporarily closed for I O transport S M EVERITY LEVEL Debug ESSAGE Node closed ACTION No action needed MSG_ID 0612 NOTICE F py EVERITY LEVEL No V DESCRIPTION An FC S M Node missing ERBOSE MASK LOG NODE 0x00000040 P2 device node has been found missing tice ESSAGE Node missing ACTION No action needed MSG_ID 0620 DEBUG Node not found ERBOSE MASK LOG NODE 0x00000040 T ESCRIPTION There was an attempt to send an I O packet to an unknown V DI device node The driver maintains a node table entry for every device it needs to communicate with on the FC network SEVERITY LEVEL Debug MESSAGE Node not found ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0621 DEBUG Node timeout ERBOSE MASK LOG NODE 0x00000040 V DESCRIPTION The node timer expired This mean
19. ERBOSE MASK LOG SLI 0x00000010 V DESCRIPTION The adapter has provided general information about the adapter s temperatur S M EVERITY LEVEL Notice ESSAGE Adapter temperatur ACTION No action needed MSG _ID 0422 WARNING Adapter temperatur VERBOSE MASK LOG SLI 0x00000010 DESCRIPTION The adapter s temperature is too hot S M EVERITY LEVEL Warning ESSAGE Adapter temperatur ACTION Check hardware ventilation Reduce adapter usage Shut down the host system T MSG_ID 0423 NOTICE Adapter notice ERBOSE MASK LOG SLI 0x00000010 V DESCRIPTION The adapter has provided general information about the adapter s condition S M EVERITY LEVEL Notice ESSAGE Adapter notice ACTION No action needed MSG ID 0424 WARNING Adapter warning Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs gt lt EMULEX eo ERBOSE MASK LOG SLI 0x00000010 V DESCRIPTION An interrupt has occurred indicating a recoverable adapter error S M EVERITY LEVEL Warning ESSAGE Adapter warning ACTION This error usually indicates a hardware or firmware problem with the adapter Check and or update firmware levels Report these errors to Emulex technical support MSG_ID 0425 ERROR Adapter error
20. EVERITY LEVEL Error ESSAGE Driver detach failed ACTION Check your hardware and software configuration If problems persist report these errors to Emulex technical support MSG_ID 0112 DEBUG Driver detach Gl V R 0x00000002 DESCRIPTION The driver is performing a detach operation S M ERBOSE MASK LOG_ DRIVI EVERITY LEVEL Debug ESSAGE Driver detach ACTION No action needed MSG_ID 0120 DEBUG Driver suspend Ed ERBOSE MASK LOG DRIVER 0x00000002 V DESCRIPTION The driver is performing a suspend operation S M EVERITY LEVEL Debug ESSAGE Driver suspend ACTION No action needed Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX MSG ID 8 emixs Logs 49 Messages gt 0121 ERROR Driver suspend failed ERBOS 0x00000002 EV ERITY L E MASK LOG DRIVER PTION EV The driver was unable to suspend due to some issue EL Error V DESCRI S M ESSAGE F Driver suspend failed ACTION persis MSG ID Check your hardware and software configuration If problems report these errors to Emulex technical support F 0130 DEBUG Driver resume ERBOS Gl E MASK LOG DRIVER 0x00000002 EV ERITY L PTION EVEL The driver is perfo
21. Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs 59 DG EMULEX Messages ACTION No action needed If problems persist report these errors to Node Emulex technical support Events MSG_ID 0600 DEBUG Node create ERBOSE MASK LOG_NODE 0x00000040 EV ERITY LEVEL Debug V DESCRIPTION A node has been created for a remote device S M ESSAGE Node create ACTION No action needed MSG_ID 0601 DEBUG Node opened ERBOSE MASK LOG NODE DETAIL 0x02000000 EV ERITY LEVEL Debug V DESCRIPTION A node has been opened for I O transport S M ESSAGE Node opened ACTION No action needed MSG ID 0602 NOTICE Gl Node create failed ERBOSE MASK LOG NODI Gl 0x00000040 EV ERITY LEVEL Notice V DESCRIPTION A node create request for a remote device has failed S M ESSAGE Node create failed ACTION No action needed MSG_ID 0603 DEBUG Node updated ERBOSE MASK LOG_NODE 0x00000040 EV ERITY LEVEL Debug V DESCRIPTION A node has been updated for a remote device S M ESSAGE Node updated ACTION No action needed MSG_ID 0610 DEBUG Node destroy ERBOSE MASK LOG NODE 0x00000040 EV ERITY LEVEL
22. FC and FCoE protocols refer to the Oracle website e For Solaris 11 1 SPARC FC and FCoE protocols refer to the Oracle website 2 Follow the instructions to install each package Uninstalling the Driver FC FCoE Driver and NIC Driver For instructions on uninstalling the FC FCoE emlxs driver and the C FCoE emlxs driver refer to the Oracle website Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 7 3 Installation gt EMULEX Utilities 1y Utilities Emulex provides three utilities to facilitate the configuration and use of the drivers for Solaris e The OneCommand Manager application e The emlxadm utility e The emlxdrv utility The OneCommand Manager Application The OneCommand Manager application provides all the functions of the emlxadm utility and a number of additional ones across multiple systems It offers a choice of a graphical user interface and a scriptable command line interface It is intended to be a direct user interface to the Fibre Channel input output FCIO interface provided by the Oracle StorEdge SFS The FCIO interface provides an Oracle common ioctl interface to the FCTL which manages the FCA drivers for each FC and FCoE adapter attached to the host system The OneCommand Manager application also directly interfaces with the Emulex OCE network driver allowing you to manage the NIC function of Emulex UCNAs Refer to the OneCommand Manager Application User Manual for more informati
23. MOD_CONFIG Warning Failed to delete MAC Check for the faulty hardware lt mac_add gt using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning oce_instance_setup max The driver supports a maximum of adapters exceeded 16 adapters MOD_CONFIG Warning oce_instance_clear illegal The driver continues to work No adapter dev lt Bus Device Fu action is necessary nc gt MOD_RX Warning oce_rx no frags The system cannot receive data because driver is low on resources Reload the driver If the same error recurs reset the adapter MOD_CONFIG Warning kstat creation failed Re load the driver MOD_CONFIG Warning Could not allocate Low System resources Repeat the stats_dbuf operation that generated the log If the error log is generated again reboot the system MOD_TX Warning wab pool empty The system cannot transmit data because driver is low on resources Check for a process generating heavy traffic MOD_TX Warning wqm pool empty The system cannot transmit data Emulex Drivers for Solaris FC and FCoE version 2 70i because driver is low on resources Check for a process generating heavy traffic P009212 01A Rev A 9 oce Logs 87 gt EMULEX Messages Table 9 1 Log Messages for the NIC Driver Continued Module Severity Message Recommended Acti
24. MSG_ID E Ring reset No action needed 0440 DEBUG Adapter msg ERBOS E MASK LOG SLI 0x00000010 PTION A message was sent to the driver from the adapter V DESCRI S M EVERITY LEVEL Debug ESSAG ACTION MSG_ID E Adapter msg No action needed 0450 ERROR IOCB invalid ERBOS ESCRI E MASK LOG SLI 0x00000010 This error may indicate a driver or firmware problem EVERITY LEVEL Error V D value S M ESSAG E IOCB invalid ACTION Emulex MSG_ID 8 emlxs Logs Messages PTION An IOCB was received from the adapter with an illegal No action needed If problems persist report these errors to technical support 0451 DEBUG IOCB queue full ERBOS E MASK LOG SLI 0x00000010 ESCRI PTION The IOCB queue is full This occurs during normal ion V D operat S M EVERITY LEVEL Debug ESSAG ACTION MSG_ID EF IOCB queue full No action needed 0452 DEBUG IOCB event ERBOS E MASK LOG SLI 0x00000010 V DESCRI a S dapter PTION An IOCB local error event is being reported by the EVERITY LEVEL Debug Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 56 DG EMULEX MESSAGE IOCB event ACTION No action needed
25. S M EVERITY LEVEL Debug ESSAGE POST diagnostic completed ACTION No action needed MSG_ID 1316 ERROR POST diagnostic failed ERBOSE MASK LOG SFS 0x00002000 V DESCRIPTION A POST diagnostic has failed to return a positive result This is usually caused by an adapter hardware problem S M EVERITY LEVEL Error ESSAGE POST diagnostic failed ACTION Contact Emulex technical support Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxsLogs 71 Messages DG EMULEX IOCTL Events MSG ID 1400 DEBUG IOCTL ERBOSE MASK LOG_IOCTL 0x00004000 V DESCRIPTION This message provides general information about the driver s IOCTL interface S M EVERITY LEVEL Debug ESSAGE IOCTL ACTION No action needed MSG_ID 1401 DEBUG IOCTL detail ERBOSE MASK LOG IOCTL DETAIL 0x04000000 V DESCRIPTION This message provides detailed information about the driver s IOCTL interface S M EVERITY LEVEL Debug ESSAGE IOCTL detail ACTION No action needed MSG ID 1410 DEBUG DFC ERBOSE MASK LOG IOCTL 0x00004000 V DESCRIPTION This message provides general information about the driver s DFC interface S M EVERITY LEVEL Debug ESSAGE DFC ACTION No action needed
26. Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs 75 SG EMULEX Messages MESSAGE Stray CT completion ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 1611 DEBUG Abnormal CT completion ERBOS ESCRI utoma E MASK LOG CT 0x00010000 PTION A CT command completed with a status error in the IOCB device on the network may not be responding The driver tically retries this CT command if needed V D The FC a S M EVERITY LEVEL Debug ESSAG ACTION of the MSG_ID E Abnormal CT completion Check the physical connections to the FC network and the state remote PortID 1620 DEBUG CT rcvd ERBOS E MASK LOG CT 0x00010000 PTION An unsolicited CT command was received EVERITY LEVEL Debug V DESCRI S M ESSAG Be CT revd ACTION MSG_ID No action needed 1621 DEBUG Unsolicited CT dropped ERBOS ESCRI E MASK LOG CT 0x00010000 PTION An unsolicited CT command was received and then dropped EVERITY LEVEL Debug ESSAG V D for some reason S M E Unsolicited CT dropped ACTION MSG_ID No action needed 1622 DEBUG CT reply ERBOS E MASK LOG CT 0x00010000 PTION A reply is being sent for an unsolicited CT comman
27. console console warnings 0x00000000 0x00000000 OxFFFFFFFF Dynamic Verbose mask for warning messages to the console console errors 0x00000000 0x00000000 OxFFFFFFFF Dynamic Verbose mask for error messages to the console cr count 255 Link reset This property specifies a count of I O completions after which an interrupt response is generated This feature is disabled if cr delay is set to 0 cr delay 63 Link reset This property specifies a count of milliseconds after which an interrupt response generated if the cr count has not been satisfied This value is set to 0 to disable the Coalesce Response feature as default enable auth 63 Link reset Enables DHCHAP support in the driver O Disabled 1 Enabled enable npiv Adapter reset This property enables NPIV support in the driver fct queue depth 4096 Reboot Queue depth of target mode port O max determined by type of HBA link speed Auto Detect Auto Detect 1 Gb s 2 Gb s 4 Gb s 8 Gb s Link reset This property sets link speed for initializing FC connection linkup delay 10 0 60 Adapter reset This property sets the linkup delay period seconds after adapter initialization log notices OxFFFFFFFF 0x00000000 OxFFFFFFFF Dynamic Verbose mask for notice messages to the messages file log warnings OxFFFFFFFF 0x00000000
28. default value is severity of CE_LWARN and MOD_MASK comprising of all modules e flow_control Sets the Ethernet flow control flow_control cannot be disabled on NIC FCoE Allowed values o 1 Transmit only o 2 Receive only o 3 Both receive and transmit e max_tx_rings Sets the maximum number of transmit queues Allowed value o 1 OCel10102 o 1 8 0Ce11102 OCe15100 e max_rx_rings Sets the maximum number of receive queues Allowed value o 1 5 OCe10102 o 1 8 0Ce11102 OCe15100 Note The actual number of tx rx queues created depends on the number of vectors allocated The actual number can be checked using dladm 1m command Configuring the NIC Interface Prerequisites The NIC interface must be created You can verify that the driver is loaded on the system and the NIC interface is created with the following command dladm show phys If the driver is not loaded on the system use the one of the following commands to load the driver For a OneConnect OCE10102 UCNA add_drv i pciex19a2 700 oce For a OneConnect OCE11102 UCNA add drv i pciexl19a2 710 oce For a OneConnect OCe15100 UCNA add _ drv i pciexl0df e220 oce Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 6 Configuring the NIC Driver 33 DG EMULEX Configuring the NIC Interface Procedure To configure the NIC interface s 1 Plumb the interface ifconfig net lt X gt plumb where X is the interface num
29. failed Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Invalid q length Must be 256 2000 Set correct queue length using dladm MOD_CONFIG Warning WQ allocation failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning WQ Buffer Pool create failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning WQ MAP Handles Pool create failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning WQ Packet Desc Pool create failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning Failed to create WQ ring Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Emulex Drivers for Solaris FC and FCoE version 2 70i Warning WCCQ create failed Check for the faulty hardware using fmadm faulty If the
30. gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit P009212 01A Rev A DG EMULEX Table 9 1 Log Messages for the NIC Driver Continued 9 oce Logs 80 Messages Module MOD_CONFIG Severity Warning Message POST ERROR Recommended Action Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning HW POST1 FAILED Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Failed to allocate bmbx Re load the driver MOD_CONFIG Warning FUNCTION RESET FAILED Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Mailbox initialization failed with lt ret code gt Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and r
31. gt G EMULEX Emulex Drivers for Solaris User Manual FC and FCoE version 2 70i NIC version 4 1 369 1s P009212 01A Rev A Emulex Connects Servers Storage and People DG EMULEX Copyright 2012 2013 Emulex All rights reserved worldwide No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of 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 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 manual as is without any warranty of any kind either expressed or implied including 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 t
32. listed in the following tables See Configuring the NIC Driver on page 31 for information on setting log levels MOD_MASK MOD CONFIG 0x0001 Messages in the device configuration path are logged MOD TX 0x0002 Messages in the transmit data path are logged MOD RX 0x0004 Messages in the receive data path are logged MOD ISR 0x0008 Messages in the interrupt path are logged SEVERITY CE_CONT 0 Continuation CE_NOTE 1 Information CE WARN 2 Warning CE PANIC 3 Causes the OS to panic CE_IGNORE 4 No action Table 9 1 Log Messages for the NIC Driver Module Severity Message Recommended Action MOD_CONFIG Warning Ring buffer allocation failed Configure the server with more lt code gt memory MOD_CONFIG Warning mcast ADD DEL failed Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Could not retrieve Reset the adapter num_bars MOD_CONFIG Warning Could not get size of bar Reset the adapter MOD_CONFIG Warning Could not map bar Reset the adapter MOD_CONFIG Warning soft_reset bit asserted 1 Check for the faulty hardware Emulex Drivers for Solaris FC and FCoE version 2 70i Reset failed using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path
33. max memory read byte count 512 1024 2048 or 4096 pm support Reboot This property enables and disables power management support in the driver 0 Disables power management support in the driver 1 Enables power management support in the driver target_depth 512 2048 Link reset Sets remote FCP target queue depth O no_limit N maximum active Os target mode Emulex Drivers for Solaris FC and FCoE version 2 70i Reboot This property enables and disables COMSTAR target mode support If target mode is enabled for that port then SFS initiator mode is disabled for that port P009212 01A Rev A SG EMULEX Table 5 1 emlxs conf Parameters Continued 5 Emulex SFS FCA Driver Properties The Configuration File emlxs conf gin Emulex Drivers for Solaris FC and FCoE version 2 70i Property Name Default Min Max Activation Comments topology 0 0 loop then P2P Link reset This property sets point to point 2 P2P only mode if you want to run as an N_Port 4 l Set to loop mode if you want to run as 100p Ony an NL_Port 6 P2P then loop ub bufs 1000 40 16320 Reboot This property sets the number of unsolicited buffers to be allocated vport restrict lo 1 0 1 Link reset This property sets the virtual port s behavior when discovering targets in the SAN Setting this property to 1 prevents the VPort from logging into other in
34. or modload kernel drv sparcv9 emlxs automap 0 for 64 bit platforms Table 5 1 emlxs conf Parameters Property Name Default Min Max Activation Comments ackO 0 0 1 Adapter Use ACKO for class 2 If ACKO is 1 the reset adapter tries to use ACKO when running Class 2 traffic to a device If the device doesn t support ACKO then the adapter uses ACK1 If ACKO is 0 only ACK1 is used when running Class 2 traffic adisc support 1 0 2 Dynamic Sets the level of driver support for the FC ADISC login I O recovery method e 1 Partial support Flush I Os for non FCP2 target devices at link down e 0 No support Flush active I Os for all FCP target devices at link down e 2 Full support Hold active I Os for all devices at link down Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A gt EMULEX Table 5 1 emlxs conf Parameters Continued 5 Emulex SFS FCA Driver Properties The Configuration File emlxs conf 28 Property Name Default Min Max Activation Comments assign alpa 0x00 0x00 Oxef Link reset This property is only valid if topology is set to loop A 0x00 setting means no preference If multiple adapter instances on the same host are on the same loop set this value differently for each adapter console notices 0x00000000 0x00000000 OxFFFFFFFF Dynamic Verbose mask for notice messages to the
35. provided by Emulex or by manually performing a set of procedures Changing Driver Properties Using the emlxs conf File The emlxs conf file contains all the properties necessary to initialize the Emulex SFS FCA driver The emlxs conf driver properties are described in Table 5 1 on page 27 In the emlxs conf file all adapter specific properties have an emlxsX prefix where X is the driver instance number For example setting emlxs0 link speed 4 makes 4 the default link speed setting for the zero instance of the driver Changes to the emlxs conf file require you to unload and reload the driver To change driver properties 1 2 3 Open the emlxs conf file in a text editor Change the properties you want Save the file See Table 5 1 on page 27 for activation requirements Enabling NPIV Support on Solaris 11 1 To enable NPIV support in the driver 1 2 3 4 Log on as root Set enable npiv to 1 in the emlxs conf file this is set to 0 by default Reboot the system If enable npiv is already set do not reboot Refer to Chapter 6 of the Solaris SAN Configuration and Multipathing Guide NPIV Configuration Limits The following limitations apply to NPIV e There is no FC IP support on virtual ports Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 4 FC FCoE Configuration DG EMULEX Configuring Target Mode Support for Solaris 11 1 e You cannot delete a virtual port with a mounte
36. the I O operations it carries out These messages may go to the system log file Comments var adm messages log warnings Min 0x00000000 log verbose Min 0x0 Max OxFFFFFFFF Max Oxffff Default 0x0000000 Verbose mask for warning messages to the messages file Default 0x0 bit mask When set to nonzero this property causes LPFC to generate additional messages concerning the state of the driver and the I O operations it carries out These messages may go to the system log file var adm messages log errors Min 0x00000000 log verbose Min 0x0 Max OxFFFFFFFF Max Oxffff Default 0x0000000 Verbose mask for error messages to the messages file Emulex Drivers for Solaris FC and FCoE version 2 70i Default 0x0 bit mask When set to nonzero this property causes LPFC to generate additional messages concerning the state of the driver and the I O operations it carries out These messages may go to the system log file var adm messages P009212 01A Rev A 39 gt EMULEX 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table 40 Configuring the NIC Interface Table 7 1 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris emlxs OneCommand Property max xfer size Solaris emlxs OneCommand Min Max Defaults and Description Min 131072 Max 1388544 Default 339968 Determines the scatter gather list buffer siz
37. to Emulex technical support MSG_ID 0330 ERROR Invalid access handle ERBOSE MASK LOG M Gl M 0x00000008 V DESCRIPTION The driver had an invalid access handle assigned by the system S M EVERITY LEVEL Error ESSAGE Invalid access handle ACTION If the problem occurs frequently report these errors to Emulex technical support MSG ID 0331 ERROR Invalid DMA handle VERBOSE MASK LOG MEM 0x00000008 DESCRIPTION The driver had an invalid dma handle assigned by the s S EE ystem EVERITY LEVEL Error Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs gt G EMULEX sin 53 MESSAGE Invalid DMA handle ACTION If the problem occurs frequently report these errors to Emulex technical support Service Level Interface SLI Events MSG_ID 0400 DEBUG Vital Product Data ERBOSE MASK LOG SLI 0x00000010 V DESCRIPTION This message provides vendor specific information about the adapter S M EVERITY LEVEL Debug ESSAGE Vital Product Data ACTION No action needed MSG_ID 0410 DEBUG Link atten ERBOSE MASK LOG SLI 0x00000010 EVERITY LEVEL Debug ESSAGE Link atten ACTION No action needed V DESCRIPTION The adapter has triggered a link atten
38. 004 ERROR ERBOSE MASK LOG MISC 0x00000001 V DESCRIPTION This is a general purpose error message S M EVERITY LEVEL Error ESSAGE None ACTION No action needed MSG _ ID 0005 PANIC VERBOSE MASK LOG MISC 0x00000001 DESCRIPTION This is a general purpose panic message S M EVERITY LEVEL Panic Severe ESSAGE None ACTION Contact Emulex technical support V DESCRIPTION This is a general purpose informational message S M V DESCRIPTION This is a general purpose informational message S M 8 emlxs Logs 46 Messages P009212 01A Rev A 8 xs L gt lt EMULEX oS MSG_ID 0010 DEBUG Event VERBOSE MASK LOG MISC 0x00000001 DESCRIPTION This is debug information about a driver event S M EVERITY LEVEL Debug ESSAGE Event ACTION No action needed MSG_ID 0011 DEBUG Event queued VERBOSE MASK LOG MISC 0x00000001 DESCRIPTION A driver event is being queued S M EVERITY LEVEL Debug ESSAGE Event queued ACTION No action needed MSG_ID 0012 DEBUG Event dequeued VERBOSE MASK LOG MISC 0x00000001 DESCRIPTION A driver event is being dequeued S M EVERITY LEVEL Debug ESSAGE Event dequeued ACTION No action needed Driver Ev
39. Command Property console notices Solaris emlxs OneCommand Min Max Defaults and Description Min 0x00000000 Max 0xFFFFFFFF Default 0x0000000 Verbose mask for notice messages to the console Related LPFC Property log verbose LPFC Min Max Default and Description Min 0x0 Max Oxf fff Default 0x0 bit mask When set to nonzero this variable causes LPFC to generate additional messages concerning the state of the driver and the I O operations it carries out These messages may go to the system console Log only for lpfc conf file Comments console warnings Min 0x00000000 Max 0xFFFFFFFF Default 0x0000000 Verbose mask for warning messages to the console log verbose Min 0x0 Max Oxf fff Default 0x0 bit mask When set to nonzero this variable causes LPFC to generate additional messages concerning the state of the driver and the I O operations it carries out These messages may go to the system console Log only for lpfc conf file console errors Emulex Drivers for Solaris FC and FCoE version 2 70i Min 0x00000000 Max 0xFFFFFFFF Default 0x0000000 Verbose mask for error messages to the console log verbose Min 0x0 Max Oxf fff Default 0x0 bit mask When set to nonzero this variable causes LPFC to generate additional messages concerning the state of the driver and the I O operations it carries out These messages may go to the system console Log o
40. Command Manager Command Line Interface User Manual e You cannot run Link Aggregation Control Protocol LACP when UMC is enabled e Using UMC ina hypervisor environment is not advised if the UMC interface is going to be part of the hypervisor virtual switch This configuration may cause performance issues Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A SG EMULEX 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table 36 Configuring the NIC Interface 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table The cross reference information listed in the table below refers to the driver for Solaris LPFC version 6 30 Table 7 1 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Solaris Solaris emlxs emlxs OneCommand Related OneCommand Min Max Defaults and LPFC LPFC Min Max Default Property Description Property and Description Comments ack0 0 The driver uses ACK1 for ackO 0 The driver uses ACK1 class 2 acknowledgement for class 2 1 The driver uses ACKO for acknowledgement class 2 acknowledgement 1 The driver uses ACKO Range Min 0 Max 1 Default 0 for class 2 faut i acknowledgement Description Determines if ACKO is used instead of ACK1 Range Min 0 Max 1 for class 2 Default 0 acknowledgement Description Determines if ACKO is used instead of ACK1 for class 2 acknowledgement adisc support 0 No support Flushes active u
41. E sae ee 60 ELS EVENTS cecia cele oteesccSldeveondenddecest seus ences cd EEEE TEETE CE CEET E ESETE E 62 General I O Packet Events sssssesssesosssescsssscsssecosesecccsssesssecosesesccsseeooo 63 FCP Traf fC EVENTS risentia een e A EE OTTE EE OR 66 FET Traffic Events ac cisciececa ded icndensec ets bidarre e enno d aa a teia a aaee 66 IP Traffic EVENS scars sess woeseace es enn e E EE EEE AR es 67 Solaris SFS Events oros erinoiiesi tini taria eE EE EE EE EEEE EEEE EEE EE EERS 69 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A D gt EMULEX Table of Contents 6 IOC TIL EVENS iiis ccic coecderws ninot rin anedu ates engudniseeaeeed mean wena tenmeeeeaerer deena 71 Firmware Download Events sssesscssscsssesocosesccssecsosesocoseccosseeeosseocosesee 72 Common Transport EVentS sesiis resni betes en EE TE EE ENTERESE EEE 74 FCSP Fibre Channel Security Protocol Events ssessssssssssssssoseseeessessesssse 76 FCF Fibre Channel Fabric Events esssesocesessossccsosesecoseccoseseeosseecosesee 77 9 OCS LOGS issia cae stasstintnacasdacaaanes ciacdecnnaereeneccaawandeeacsearvataranscduvecsanedeesars 79 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 1 Introduction gt G EMULEX Abbreviations t3 1 Introduction This document provides the information needed to use the Emulex Fibre Channel FC and Fibre Channel over Ethernet FCoE driver for Solaris StorEdge SAN Fou
42. EVERITY LEVEL Debug ESSAGE FCSP state ACTION No action needed MSG_ID 1706 DEBUG FCSP event Emulex Drivers for Solaris FC and FCoE version 2 70i VERBOSE MASK LOG FCSP 0x00020000 DESCRIPTION An error was found while processing a DFC request S M VERBOSE MASK LOG FCSP 0x00020000 DESCRIPTION An authentication state is changing S M P009212 01A Rev A DG EMULEX EVERITY LEVEL Debug ESSAGE FCSP event ACTION No action needed MSG_ID 1707 DEBUG FCSP status EVERITY LEVEL Debug ESSAGE FCSP status ACTION No action needed MSG_ID 1710 DEBUG FCSP start VERBOSE MASK LOG FCSP 0x00020000 DESCRIPTION An authentication event has occurred S M VERBOSE MASK LOG FCSP 0x00020000 DESCRIPTION An authentication status is being updated S M ERBOSE MASK LOG FCSP 0x00020000 EVERITY LEVEL Debug ESSAGE FCSP start ACTION No action needed MSG_ID 1720 DEBUG FCSP comp ERBOSE MASK LOG FCSP 0x00020000 EVERITY LEVEL Debug ESSAGE FCSP comp ACTION No action needed V D node S M FCF Fibre Channel Fabric Events MSG ID 1800 DEBUG FCF ERBOSE MASK EVERITY LEVEL Debug ESSAGE FCF ACTION No action needed V D driver s FCF interface S M
43. FCoE version 2 70i P009212 01A Rev A D gt EMULEX Table of Contents 5 4 FC FCOE Configuration sasucsievrsardcavaitanhanavddadenaaubataiadehasanesannadiaaaddadasene 25 IntroduUCti M cicsieanseusenadausiuddnadeencvexdecaxonvaebecasercane lease NEE E NEE EES 25 Changing Driver Properties Using the emlxs conf File cecssccccccccsccccessscees 25 Enabling NPIV Support on Solaris 19 Uo ccccicscdsicccaccccicdsdavesdas bce saedsbaaseenedeeaeassd 25 NPIV Configuration Limits iccciicsviciciaevs cccswedissecusicctesccvesctvcvedeasaeecseweses ease 25 NPIV and OS Virtualization saxiecs coecswwess cued lees teaesuatesgeludn EEEE TERNERA 26 Using VPorts with Oracle VM Server for SPARC and ContainerS eeeeeeees 26 Configuring Target Mode Support for Solaris 11 1 cccccsccccessccccccccsccccessseses 26 5 Emulex SFS FCA Driver PropertieS seeseeseeseeseesecsecsecsecsecsecsecsecsecsecse 27 The Configuration File CMIXS CONF ssccccccsccccccssccccccccscccccesssssseseesssseees 27 6 Configuring the NIC Driver sssesseccecceccecceccecoecsecsecsecseececseccecsecsecseo 31 Configuring the NIC Interface ssssesssssessosecossseccssseccsosecososesossseceosesssoseeee 32 PREFEGUISILES iyscc cs s sssncd crcsns cen ceeaen Mem ba oE sis se AEE ENEE EERE EEE EEEE 32 PROCCCUIC ais cse voce tis cc cases sess encoders cenccesG ES EEEE Fe Canes sag ETANTE EEN a 33 dladm S pport on Solaris THAN aeir cau antebatcanecdo
44. INIT 0x00000004 DESCRIPTION The adapter is initializing SEVERITY LEVEL Debug MESSAGE Adapter initialization ACTION No action needed MSG _ID ERBOS ESCRI EV 0210 DEBUG Adapter transition E MASK LOG INIT 0x00000004 PTION The adapter is changing states ERITY L EV EL Debug V D S M ESSAGE Adapter transition ACTION No action needed MSG _ID V D S M ERBOS ESCRI EV ERITY L 0220 DEBUG Adapter online E MASK LOG INIT 0x00000004 PTION The adapter is online and ready to communicate EV EL Debug ESSAGE Adapter online ACTION No action needed MSG ID V D S M MSG_ID V D E S M ERBOS ESCRI EV ERITY L 0230 DEBUG Adapter offline E MASK LOG INIT 0x00000004 PTION The adapter is offline and unable to communicate EV ES EL Debug SAGE Adapter offline ACTION No action needed ERBOS ESCRI einitiali EV ERITY L Ze 0231 WARNING Adapter shutdown E MASK LOG INIT 0x00000004 PTION The adapter has been shutdown and requires a reboot to EV EL Warning ES SAGE Adapter shutdown Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX ACTION Conta MSG_ID 0240 E
45. K V DESCRIPTION A firmware core dump has occurred S M ESSAGE Firmware dump 8 emlxs Logs 74 Messages your hardware configuration If problems persist report these errors to Emulex technical support LOG FIRMWARE 0x00008000 EVERITY LEVEL Warning V DESCRIPTION A firmware update is required on the adapter S M ESSAGE Firmware update required ACTION To trigger an automatic firmware download you must perform a manual adapter reset or link reset onc the host environment is stable Caution Do not power cycle or reboot the system during the download operation Common Transport Events MSG_ID 1600 DEBUG CT sent ERBOSE MASK LOG CT 0x00010000 EVERITY LEVEL Debug V DESCRIPTION A CT command is being sent S M ESSAGE CT sent ACTION No action needed MSG_ID 1601 DEBUG CT comp ERBOSE MASK EVERITY LEVE LOG_CT 0x00010000 1 Debug ACTION No ac MSG ID 1610 VERBOSE MASK V DESCRIPTION A CT command completed normally S M ESSAGE CT comp tion needed ERROR Stray CT completion LOG_CT 0x00010000 DESCRIPTION A CT command completion was received without issuing a corresponding CT command This error may indicate a driver or firmware problem SEVERITY LEVEL Error Emulex Drivers for
46. RBOSE MASK ry pool error tion needed If problems persist report these errors to cal support DEBUG Memory pool alloc failed OG MEM 0x00000008 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs gt lt EMULEX oo ESCRIPTION The driver was unable to allocate memory from one of its wn memory pools D fe SEVERITY LEVEL Debug M ESSAGE Memory pool alloc failed ACTION If the problem occurs frequently you may be able to configure more resources for that pool If this does not solve these problems report these errors to Emulex technical support MSG ID 0312 DEBUG Memory pool detail ERBOSE MASK LOG MEM 0x00000008 V DESCRIPTION This message provides detailed information about memory buffer pool management S M EVERITY LEVEL Debug ESSAGE Memory pool detail ACTION No action needed MSG_ID 0320 NOTICE No unsolicited buffer available ERBOSE MASK LOG MEM 0x00000008 V DESCRIPTION The driver s unsolicited buffer pool is exhausted The I O is dropped and is most likely retried by the remote devic S M EVERITY LEVEL Notice ESSAGE No unsolicited buffer available ACTION If the problem occurs frequently you may be able to configure more resources for that pool If this does not solve these problems report these errors
47. RBOSE MASK 8 emlxsLogs 51 Messages ct Emulex technical support ERROR Adapter reset failed LOG INIT 0x00000004 EVERITY LEVE L Error ESSAGE Adap ACTION Check these errors V DESCRIPTION An attempt to reset the adapter has failed S M ter reset failed your hardware configuration If problems persist report to Emulex technical support Memory Management Events MSG ID 0300 ERBOSE MASK EVERITY LEVE DEBUG Memory alloc OG MEM 0x00000008 The driver allocated system memory V DESCRIPTION S M ESSAGE Memo ACTION No ac MSG ID 0301 ERBOSE MASK ESCRIPTION 1 Debug ry alloc tion needed ERROR Memory alloc failed LOG M GI M 0x00000008 The driver was unable to allocate system memory The EVERITY LEVE L Error ESSAGE Memo ACTION No ac your systema MSG ID 0310 ERBOSE MASK V D system is low on memory resources S M ry alloc failed tion needed If problems persist report these errors to dministrator ERROR Memory pool error LOG M Gl M 0x00000008 ESCRIPTION A problem has occurred with the memory buffer pool EVERITY LEVE L Error V D management S M ESSAGE Memo ACTION No ac Emulex techni MSG ID 0311 VE
48. SCRIPTION This message provides detailed information about the driver s FCT interface S M EVERITY LEVEL Debug ESSAGE FCT detail ACTION No action needed MSG_ID 1110 DEBUG FCT debug ERBOSE MASK LOG_FCT 0x00000800 V DESCRIPTION This message provides general information about the driver s FCT interface S M EVERITY LEVEL Debug ESSAGE FCT debug ACTION No action needed MSG _ ID 1120 DEBUG FCT error ERBOSE MASK LOG FCT 0x00000800 V DESCRIPTION A general error has occurred in the driver s FCT interface S M EVERITY LEVEL Debug ESSAGE FCT error ACTION No action needed If problems persist report these errors to Emulex technical support MSG ID 1130 DEBUG FCT API ERBOSE MASK V DESCRIPTION This message provides an API trace with the driver s FCT interface S M EVERITY LEVEL Debug ESSAGE FCT API ACTION No action needed IP Traffic Events MSG_ID 1200 DEBUG IP detail ERBOSE MASK LOG IP DETAIL 0x08000000 V DESCRIPTION This message provides detailed information about the driver s IP interface S M EVERITY LEVEL Debug ESSAGE IP detail ACTION No action needed Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Log
49. SK LOG DRIV PTION This message shows the versions of firmware contained in TY LEVEL Notice V D the driver s library S M ESSAG E Firmware library ACTION No action needed MSG ID 1510 ERROR Bad firmware image ERBOS E MASK LOG FIRMWARE 0x00008000 ESCRI uncti EVERI PTION A bad firmware image was provided to the download on TY LEVEL Error V D S M ESSAG E Bad firmware image ACTION Obtain the proper image file If problems persist report these errors to Emulex technical support MSG_ ID 1511 ERROR Firmware image not compatible Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX ERBOS ESCRI E MASK LOG FIRMWARE EVERITY LEVEL PTION MECOK ESSAG ACTION errors MSG_ID Obtain the proper image file If problems persist to Emulex technical 1520 NOTICE ERBOS X E MASK LOG FIRMWARE EVERITY LEVEL PTION An attempt to Notice V DESCRI S M ESSAG ACTION MSG_ID No action needed 1521 NOTICE ERBOS T E MASK LOG FIRMWARE EVERITY LEVEL PTION An attempt to Notice V DESCRI S M ESSAG E Firmware download ACTION MSG_ID No action needed
50. Solaris driver pages of the Emulex website for compatibility between drivers and applications Prerequisites e Ifan earlier version of the emlxu utilities package is already installed on the system and you want to install a different version follow the instructions in Uninstalling the Utilities Package Manually on page 24 then return to this section to install the new utilities package Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 3 Installation 22 DG EMULEX Uninstalling the FCA Utilities and the OneCommand Manager Application Procedure To install the emlxu utilities package manually 1 2 Log on as root Copy the utilities kit from the distribution medium into a directory referred to here as lt directory gt The utilities kit is a tar file named something similar to emlxu_kit 1 01c sparc tar Change to the directory where you put the kit tar file by typing cd lt directory gt Extract the installation images from the tar file by typing tar xvf emlxu_kit lt version gt sparc tar Install the EMLXemlxu utilities package by typing pkgadd d EMLXemlxu The package is prepared for installation and you are prompted to confirm the installation with the following message Do you want to continue with the installation of lt EMLXemlxu gt y n Enter lt y gt The installation progress is indicated Examine the output for any errors or warnings If the installation is successfu
51. ailable online in the opt HBAnyware README_WEBLAUNCH txt file e Apache Web server must be installed and running on the server that is hosting the Web Launch Service software e The Java Web Start application must be installed and running on the browser host e The system on which you are installing the Web Launch Service package the server requires o An HTTP server configured to handle the JNLP MIME file type The following MIME file type file extension must be added to your server configuration MIME type application x java jnlp fil File Extension jnlp o The HTTP server must be running e The system on which you are running the browser the client requires that Java be installed The specific requirements are o Oracle s 32 bit Java 6 0 or later for Intel based systems A64 o 32 bit Java 6 0 or later for x64 systems Refer to the appropriate vendor documentation for detailed instructions about configuring MIME types configuring and starting the HTTP server and installing the JRE See opt HBAnyware README_WEBLAUNCH txt for more setup information Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 3 Installation 21 gt EMULEX Installing the FCA Utilities and the OneCommand Manager Application Procedure To install the OneCommand Manager application Web Launch Interface 1 Log on as root 2 Navigate to the OneCommand Manager application directory Type cd opt HBAnyware
52. are is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning kstat setup Failed with Re load the driver lt ret_code gt MOD_CONFIG Warning MAC allocation Failed Unload and then re load the driver MOD_CONFIG Warning MAC registration failed Unload and then re load the Emulex Drivers for Solaris FC and FCoE version 2 70i driver P009212 01A Rev A DG EMULEX Table 9 1 Log Messages for the NIC Driver Continued 9 oce Logs 83 Messages Module MOD_CONFIG Severity Warning Message Detach failed lt num_buffers gt pending buffers in rq lt rq_id gt Recommended Action Reset the adapter MOD_CONFIG Warning Failed to query fw config Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Failed to get stats Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning EQ ring alloc failed Low System resources Repeat the operation t
53. ber To see the interfaces created run gt dladm show link This command lists all the interfaces in the system 2 Assign an IP address ifconfig net lt xX gt lt IP Address gt netmask lt NetMask gt up 3 Edit the etc hosts file a symlink to etc inet hosts and add the IP address and hostname that you wish to assign to the given NIC interface Refer hosts 4 for more information 4 Edit the etc inet ipnodes file and add an entry for the IP address and hostname for the given interface The etc inet ipnodes file is primarily for IPv6 only but this step is necessary for the IP address change to take effect 5 Edit the etc netmasks file and add an entry with the IP address and desired subnet mask for the given interface Refer netmasks 4 for more information 6 Restart the network service Use gt svcadm restart network physical or Reboot the system To remove the interface Perform the steps detailed in configuring the NIC interface in reverse order Remove all the entries in the files and unplumb the interface using the following command ifconfig net lt X gt down unplumb Alternatively use sysconfig 1M to delete the configurations of IP address netmask hostname nfs mounts ldap etc on the host The sysconfig utility reboots the system and clear all existing IP configuration so you must enter all the information again even for the existing NICs already configured in the system The sysconfig utility m
54. can also set individual paths to target mode mlxsX target mode 1 Where X is the specific numeric path For example when emlxs1 is set to target mode all other paths stay in initiator mode Uncomment the line ddi forceattach 1 Reboot the system To configure targets refer to the Oracle COMSTAR Administration document Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 5 Emulex SFS FCA Driver Properties 27 gt G EMULEX The Configuration File emlxs conf 5 Emulex SFS FCA Driver Properties The emlxs conf file contains all the properties necessary to initialize the Emulex SFS FCA driver Note The OneCommand Manager application reflects the emlxs conf driver properties See the OneCommand Manager Application User Manual for more information about using the OneCommand Manager application with the Emulex SFS FCA driver Note All properties are adapter specific The Configuration File emlxs conf In the emlxs conf file all adapter specific parameters have emlxsX prefix where X is the driver instance number for example setting emlxs0 link speed 4 makes 4 Gb s the default link speed WARNING Changes to the emlxs conf file require you to unload and reload the driver Note If you want to override a driver parameter for a single driver loading session you can specify it as a parameter with the modload command For example modload kernel drv emlxs automap 0 for 32 bit platforms
55. cquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Config vlan failed Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Failed to Setup handlers Re load the driver MOD_CONFIG Warning Hardware UE Detected Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Failed to retrieve intr types Unload and then re load the driver MOD_CONFIG Warning MSIX not supported The system continues to work with INTX MOD_CONFIG Warning Could not get supported intrs Re load the driver MOD_CONFIG Warning Alloc intr failed Re load the driver MOD_CONFIG Warning Unable to get intr priority Re load the driver MOD_CONFIG Warning Failed to add interrupt handler Re load the driver MOD_CONFIG Warning Emulex Drivers for Solaris FC and FCoE version 2 70i Interrupts block enable failed Re
56. d V DESCRI S M EVERITY LEVEL Debug ESSAG ACTION MSG_ID E CT reply No action needed 1630 ERROR Invalid CT command found VERBOS E MASK LOG CT 0x00010000 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX DESCRIPTION 8 emlxs Logs 76 Messages A CT command was found with an invalid command code SEVERITY LEV EL Error MESSAGE Invalid CT command found ACTION No action needed If problems persist report these errors to Emulex technical support FCSP Fibre Channel Security Protocol Events MSG_ID 1700 ERBOSE MASK ESCRIPTION DEBUG FCSP LOG FCSP 0x00020000 This message provides general information about the P interface EVERITY LEV EL Debug V D driver s FCS S M D ESSAGE FCSP ACTION No action needed MSG ID 1701 ERBOSE MASK ESCRIPTION DEBUG FCSP detail LOG _FCSP DETAIL 0x01000000 This message provides detailed information about the EVERITY LEVEL Debug ESSAGE FCSP detail ACTION No action needed V D driver s FCSP interface S M MSG_ID 1702 DEBUG FCSP error EVERITY LEVEL Debug ESSAGE FCSP error ACTION No action needed MSG_ID 1705 DEBUG FCSP state
57. d file system e Due to the limitation of the Solaris Leadville stack deleting a virtual port causes that virtual port to go offline e The Emulex LightPulse LP11000 and LPe11000 family of adapters can support up to 100 virtual ports e The Emulex LightPulse LPe12000 family of adapters can support up to 255 virtual ports NPIV and OS Virtualization Solaris has several OS virtualization solutions including Oracle VM for SPARC and containers Devices configured to be seen on an Emulex Fibre Channel or Ethernet port either a physical port or a virtual port can be used with any of these OS Virtualization solutions Emulex strongly recommends that you consult the latest document on these 26 technologies to learn the best use of resources related to NPIV technology Using VPorts with Oracle VM Server for SPARC and Containers Using NPIV with Oracle VM Server for SPARC formerly Logical Domains and Solaris containers user domains is simple 1 Create virtual ports for the domains containers to which you want to present dedicated storage Discover and attach the targets to virtual ports Assign the target not the port to the domain or container The attachment runs through the virtual port which provides the path to the target Configuring Target Mode Support for Solaris 11 1 To configure target mode support for Solaris 11 1 1 2 4 Log on as root Set target mode to 1 in the emlxs conf file You
58. e A pool of buffers is reallocated by the driver during boot A larger transfer size requires a larger memory allocation Related LPFC Property N A LPFC Min Max Default and Description Comments network on Min O Disables Max 1 Enables Default 1 Description Enables or disables IP networking support in the driver Emulex Drivers for Solaris FC and FCoE version 2 70i network on Min O Disables Max 1 Enables Default 0 Description Controls whether LPFC provides IP networking functionality over FC This property is Boolean when zero IP networking is disabled When non zero IP networking is enabled This variable is set during the installation of the driver via pkgadd P009212 01A Rev A 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table 41 gt G EMULEX Configuring the NIC Interface Table 7 1 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris Solaris emlxs emlxs OneCommand Related OneCommand Min Max Defaults and LPFC LPFC Min Max Default Property Description Property and Description Comments num iocbs Min 128 num iocbs Min 128 Max 10240 Max 10240 Default 1024 Default 256 Description Sets the number Description Specifies the of iocb buffers to allocate number of command buffers to allocate These buffers are used for Fibre Channel Extended Link Services ELS and one for each FCP com
59. ement capability to one of the values defined for Solaris FM capability It is a bitmap of one or more of the following values DDI_FM_NOT_CAPABLE 0x00000000 DDI_FM_EREPORT_CAPABLE 0x00000001 DDI_FM_ACCCHK_CAPABLE 0x00000002 DDI_FM_DMA_CHK_CAPABLE 0x00000004 DDI_FM_ERRCB_CAPABLE 0x00000008 By default this value is set to 7 See Solaris FMA documentation for more information e oce_log_level Sets the driver s verbosity level in messages logged in var adm messages A higher verbosity level is intended for field logs and affects hardware performance By default verbosity is set to 0 which is the least verbose This value is of the form MOD_MASK SEVERITY where MOD_MASK MOD_CONFIG 0x0001 Messages in the device configuration path are logged MOD_TX 0x0002 Messages in the transmit data path are logged MOD_RX 0x0004 Messages in the receive data path are logged MOD_ISR 0x0008 Messages in the interrupt path are logged SEVERITY CE_CONT 0 Continuation Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 6 Configuring the NIC Driver 32 gt G EMULEX Configuring the NIC Interface CE_NOTE 1 Information CE_WARN 2 Warning CE_PANIC 3 Causes the OS to panic CE_IGNORE 4 No action The severity is one of the listed severity levels For a set level of severity only messages of that level and higher are logged For example if severity is set to CE_WARN then messages with CE_CONT and CE_NOTE are not logged The
60. ents MSG_ID 0100 NOTICE Driver attach T VERBOSE MASK LOG DRIVER 0x00000002 DESCRIPTION The driver is performing an attach operation S M EVERITY LEVEL Notice ESSAGE Driver attach ACTION No action needed MSG_ID 0101 ERROR Driver attach failed VERBOSE MASK LOG DRIVER 0x00000002 DESCRIPTION The driver was unable to attach due to some issue S M EVERITY LEVEL Error ESSAGE Driver attach failed ACTION Check your hardware and software configuration If problems persist report these errors to Emulex technical support Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 Ixs L E EMULEX oee MSG_ID 0102 DEBUG Driver attach Gl V R 0x00000002 DESCRIPTION The driver is performing a attach operation S M ERBOSE MASK LOG DRIVI EVERITY LEVEL Debug ESSAGE Driver attach ACTION No action needed MSG_ID 0110 NOTICE Driver detach Gl ERBOSE MASK LOG DRIVER 0x00000002 V DESCRIPTION The driver is performing a detach operation S M EVERITY LEVEL Notice ESSAGE Driver detach ACTION No action needed MSG_ID 0111 ERROR Driver detach failed VERBOSE MASK LOG DRIVER 0x00000002 DESCRIPTION The driver was unable to detach due to some issue S M
61. ers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX NIC NPIV PCI PKT PLOGI POST PRLI RSCN RSS SAN SCSI SFS SLI SPARC TXQ UCNA UI UMC 1 Introduction 14 Abbreviations network interface card or controller N_Port ID virtualization peripheral component interconnect packet port login power on self test process login registered state change notification receive side scaling storage area network small computer system interface SAN Foundation Software service level interface Scalable Processor Architecture transmit queue universal converged networking adapter user interface universal multichannel Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 2 Important Considerations 15 SG EMULEX Known Issues 2 Important Considerations e Supports FC FCoE and NIC on Solaris 11 1 e Supports NIC for Crossbow vNIC vSwitch and vRouter on Solaris 11 1 e OneConnect OCe11100 series NIC adapters support advanced mode with an increase in RSS capabilities e Supports NIC DLADM which provides Maximum Transmission Unit MTU size access and FMA enablement on Solaris 11 1 Known Issues See the product release notes for the latest information Driver Information emlxs and oce Prerequisites The drivers described in this document are distributed by Oracle as part of the following operating environments e Solaris 11 1 SPARC e Solaris 11 1 x64 Compatibility
62. eset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Firmware version read failed with lt ret code gt Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Emulex Drivers for Solaris FC and FCoE version 2 70i Warning Firmware configuration read failed with lt ret code gt Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit P009212 01A Rev A DG EMULEX Table 9 1 Log Messages for the NIC Driver Continued 9 oce Logs 81 Messages Module MOD_CONFIG Severity Warning Message MAC address read failed with lt ret code gt Recommended Action Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Interface creation failed for group instance Check for the faulty hardware using fmadm faulty If the hardware is faulty a
63. for Solaris FC and FCoE version 2 70i P009212 01A Rev A SG EMULEX Table 8 2 Log Message Types Continued 8 emlxs Logs 44 Messages LOG Message Verbose flags Verbose Bit Verbose Description MSG_INIT 0x00000004 HBA initialization events MSG_MEM 0x00000008 Memory management events MSG_SLI 0x00000010 Service Level Interface SLI events MSG_MBOX 0x00000020 Mailbox events MSG_NODE 0x00000040 Node events MSG_LINK 0x00000080 Link events MSG_ELS 0x00000100 ELS events MSG_PKT 0x00000200 General I O packet events MSG_FCP 0x00000400 FCP traffic events MSG_FCT 0x00000800 FCP target mode events MSG_IP 0x00001000 IP traffic events MSG_SFS 0x00002000 Solaris SFS events MSG_IOCTL 0x00004000 IOCTL events MSG_FIRMWARE 0x00008000 Firmware download events MSG_CT 0x00010000 CT events MSG_FCSP 0x00020000 FCSP events MSG_FCF 0x00040000 FCF events MSG_RESV19 0x00080000 MSG_RESV20 0x00100000 MSG_RESV21 0x00200000 MSG_FCT_API 0x00400000 FCP Target Mode API trace MSG_FCT_DETAIL 0x00800000 Detailed FCT events MSG_FCSP_DETAIL 0x01000000 Detailed FCSP events MSG_NODE_DETAIL 0x02000000 Detailed node events MSG_IOCTL_DETAIL 0x04000000 Detailed IOCTL events MSG_IP_DETAIL 0x08000000 Detailed IP events MSG_FIRMWARE_DETAIL 0x10000000 Detailed Firmware events MSG_SFS_DETAIL 0x20000000 Detailed Solaris SFS events MSG_MBOX_DETAIL 0x40000000 De
64. hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit P009212 01A Rev A DG EMULEX Table 9 1 Log Messages for the NIC Driver Continued 9 oce Logs 85 Messages Module MOD_CONFIG Severity Warning Message WQ create failed Recommended Action Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning RQ allocation failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning RQ bdesc alloc failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning RQ shadow ring alloc failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning RQ ring create failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning RQ create failed Check for the faulty hardware using fmadm faulty If t
65. hat generated the log If the error log is generated again reboot the system MOD_CONFIG Warning EQ create failed Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning CQ allocation failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning CQ ring alloc failed Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Emulex Drivers for Solaris FC and FCoE version 2 70i Warning CQ create failed Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit P009212 01A Rev A DG EMULEX Table 9 1 Log Messages for the NIC Driver Continued 9 oce Logs 84 Messages Module MOD_CONFIG Severity Warning Message MQ ring alloc failed Recommended Action Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system MOD_CONFIG Warning MQ create
66. he hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Failed to del q Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Emulex Drivers for Solaris FC and FCoE version 2 70i Warning Failed to set EQ delay Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit P009212 01A Rev A DG EMULEX Table 9 1 Log Messages for the NIC Driver Continued 9 oce Logs 86 Messages Module Severity Message Recommended Action MOD_CONFIG Warning Failed to Configure RSS Check for the faulty hardware using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning MAC addition failed Re load the driver MOD_CONFIG Warning Could not find the MAC Provide the correct MAC address lt mac addr gt
67. ime 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 manual Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A SG EMULEX List of Tables 3 List of Tables Table 5 1 emlxs conf Parameters orserrira nisi reres Enteri EE EEE E EEEE EAEE 27 Table 7 1 Solaris emlxs and Solaris LPFC Driver Property Cross Reference 65 36 Table 8 1 Notice Warnings and Error Types ccccssccccceccccceeecsccceeessescceessees 43 Table 8 2 Log Message TYPGS 0 05 c0riesnies cone seen se eve e scene sede seneee oveeee teas EEEE RRES 43 Table 8 3 Severity Levels iidioestus ode cadates sa TEn EEE E EER Ea 45 Table 9 1 Log Messages for the NIC Driver ccccsccccccescccceessscceeeeeseseeeeesees 79 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A D gt EMULEX Table of Contents 4 Table of Contents LISE OF TaDleS cswincciissccccaccacisantanacccrnenscacnadsessnnuns sacauansadaasauneeecaeaadeudseianecass 3 Ty INGPOMUCEION is cow cicadas caesaussavasiuansdeviais diecuiaiardvavacsivesdasaaaesevesnasnberaaeds 13 ADDI EVIGUIONG sccerssinnsccucecsinonta
68. ing migration from the Solaris LPFC driver to the Solaris SFS driver Refer to the Solaris FCA Utilities User Manual and the OneCommand Manager Application User Manual for information on using these utilities Procedure To install the FCA Utilities and the OneCommand Manager application 1 Copy the Solaris utility kit to a temporary directory on your system 2 Untar the utility kit tar xvf elxocm solaris lt version gt tar 3 Change to the newly created elxocm solaris lt version gt directory cd elxocm solaris lt version gt 4 Run the install script to begin installation Note Ifthe HBAnyware utility the OneCommand Manager Core Kit or the OneCommand Manager Enterprise applications or the Solaris driver utilities are already present on the system the install script attempts to remove them first install 5 When prompted enter the type of management you want to use il Local Mode HBA s on this Platform can be managed by OneCommand clients on this Platform Only 2 Managed Mode HBA s on this Platform can be managed by local or remote OneCommand clients 3 Remote Mode Same as 2 plus OneCommand clients on this Platform can manage local and remote HBA s 6 If you answered lt 2 gt or lt 3 gt in step 5 you are asked if you want the OneCommand Manager application to operate in read only mode Read only mode prevents users from performing certain operations such as resetting adapters updating an adapter s fir
69. ink is up for all virtual ports S M VERBOSE MASK LOG LINK 0x00000080 DESCRIPTION An issue has forced the FC link to be reset S M or LOG SFS 0x00002000 MSG ID 0731 ERROR Link reset failed Emulex Drivers for Solaris FC and FCoE version 2 70i VERBOSE MASK LOG LINK 0x00000080 DESCRIPTION An attempt to reset the FC link has failed or LOG SFS 0x00002000 P009212 01A Rev A 8 emlxs Logs Messages DG EMULEX SEVERITY LEVEL Error MESSAGE Link reset failed ACTION No action needed If problems persist report these errors to Emulex technical support ELS Events MSG_ID 0800 DEBUG ELS sent VERBOSE MASK LOG ELS 0x00000100 DESCRIPTION An ELS command is being sent S M EVERITY LEVEL Debug ESSAGE ELS sent ACTION No action needed MSG_ID 0801 DEBUG ELS comp VERBOSE MASK LOG ELS 0x00000100 DESCRIPTION An ELS command completed normally S M EVERITY LEVEL Debug ESSAGE ELS comp ACTION No action needed MSG_ID 0810 ERROR Stray ELS completion ERBOSE MASK LOG ELS 0x00000100 V DESCRIPTION The ELS command completion was received without issuing a corresponding ELS command This error may indicate a driver or firmware problem S M EVERITY LEVEL Error
70. itiator ports on the SAN Also rejects log ins from other ports in the SAN because it assumes that all ports that send a PLOGI are Initiators When this parameter is turned off 0 the driver attempts to log in to every port that it can access in the SAN and accept log ins from all ports Note In a SAN where there are other initiators this feature greatly reduces the hardware resources the driver uses P009212 01A Rev A 30 6 Configuring the NIC Driver 31 gt G EMULEX The Configuration File emlxs conf 6 Configuring the NIC Driver The driver exports certain parameters that can be configured by editing the oce conf file If the oce conf file is not present on the system create the oce conf file in the kernel drv directory To edit the oce conf file 1 2 Open the file in a text editor Make the relevant changes and save the file The format of a single line in the file is as follows lt variable gt lt value gt For example oce_default_mtu 9000 Comment lines must start with a character If the driver is already loaded unload the driver and re load it for the changes to take effect See Uninstalling the Drivers on page 16 for more information The following parameters are configurable through the oce conf file e oce_default_mtu The default MTU The Emulex UCNA supports 1500 and 9000 byte MTU sizes By default it is set to 1500 e oce_fm_capability Sets the driver s fault manag
71. l the following message is displayed near the end of the process Installation of lt EMLXemlxu gt was successful The emlxu utilities installation is complete The utility package s programs are located in the opt EMLXemlxu bin directory You do not have to reboot the system to run a utility program but you must either enter the program s full path name or add the package s bin directory opt EMLXemIxu bin to the system environment s search path To use the man pages provided by the package you must also add the package s man directory opt EMLXemlxu man to the system environment s man path Uninstalling the FCA Utilities and the OneCommand Manager Application Uninstalling the OneCommand Manager Application Note If you installed the OneCommand Manager application Web Launch Interface 1 2 you must uninstall it before uninstalling the OneCommand Manager application See Uninstalling the OneCommand Manager Application with Web Launch Only on page 23 Log on as root Run the OneCommand Manager uninstall script opt HBAnyware scripts uninstall Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 3 Installation 23 gt EMULEX Uninstalling the FCA Utilities and the OneCommand Manager Application Uninstalling the OneCommand Manager Application with Web Launch Only 1 Log on as root Note If you installed the OneCommand Manager application Web Launch Interface y
72. load the driver P009212 01A Rev A SG EMULEX Table 9 1 Log Messages for the NIC Driver Continued 9 oce Logs 82 Messages Module Severity Message Recommended Action MOD_CONFIG Warning Failed to enable ret lt ret Re load the driver code gt interrupt lt int num gt type lt int type gt cnt lt num_vectors gt MOD_CONFIG Warning Interrupt block disable Reset the adapter failed MOD_CONFIG Warning Failed to disable the Reset the adapter interrupts MOD_CONFIG Warning mod_install failed rval Reset the adapter MOD_CONFIG Warning Map PCI config failed with Reset the adapter lt ret_code gt MOD_CONFIG Warning Device Unknown The device is not supported by the driver MOD_CONFIG Warning PCI initialization failed Reset the adapter MOD_CONFIG Warning HW initialization failed with Check for the faulty hardware ret_code using fmadm faulty If the hardware is faulty acquit the hardware using fmadm acquit lt dev_path gt and reset the adapter If the hardware is not faulty reset the adapter without issuing acquit MOD_CONFIG Warning Interrupt setup failed with Re load the driver lt ret_code gt MOD_CONFIG Warning Failed to init rings Low system resources Reboot the system to see if the problem resolves itself If possible add more memory MOD_CONFIG Warning Failed to setup adapter Check for the faulty hardware using fmadm faulty If the hardw
73. mand issued in SLI 2 mode To queue lots of FCP commands to the adapter increase num bufs for better performance These buffers consume physical memory and are used by the device driver to process loop initialization and rediscovery activities Important The driver must always be configured with at least several dozen ELS command buffers Emulex recommends at least 128 num nodes Min 2 N A N A Max 512 Default 512 Description Number of FC nodes NPorts the driver supports pci max read Min 512 N A N A Max 4092 Default 2048 Description Sets the PCI X max memory read byte count 512 1024 2048 or 4096 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A gt EMULEX 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table 42 Configuring the NIC Interface Table 7 1 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris Solaris emlxs emlxs OneCommand Related OneCommand Min Max Defaults and LPFC LPFC Min Max Default Property Description Property and Description Comments pm support 0 Disables power N A N A management support in the driver 1 Enables power management support in the driver Default 0 Description Enable and disables power management support in the driver topology 0 loop if it fails attempt topology 0x0 loop if it fails The topology pt to pt attempt pt to pt property controls the
74. move when ready to uninstall gt Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 3 Installation 20 DG EMULEX Installing the FCA Utilities and the OneCommand Manager Application The script leaves a copy of the emlxu_remove script in the working directory with the original utilities kit tar file You can remove this script or leave it in the directory and use it to uninstall the emlxu utilities from your system in the future See Installing or Updating the Utilities Package Manually on page 21 for more details The emlxu utilities installation is complete The utility programs are located in the opt EMLXemlxu bin directory You do not have to reboot the system to run a utility program but you must either enter the program s full path name or add the package s bin directory opt EMLXemIxu bin to the system environment s search path To use the man pages provided by the package you must also add the package s man directory opt EMLXemlxu man to the system environment s man path For further information on installing and removing packages refer the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manual pages Installing the OneCommand Manager Application with Web Launch Prerequisites In addition to the driver and the OneCommand Manager application the following prerequisites must be met before you install the Web Launch feature Note This information is also av
75. mware and changing adapter driver properties and bindings It only affects the local OneCommand Manager application interface These operations can still be performed using remote management Enter lt y gt for yes to allow the user to perform these operations enter lt n gt for no if read only mode is desired 7 You are prompted about allowing users to change the management mode after installation Enter lt y gt for yes or lt n gt for no This installs the OneCommand Manager application and emlxu_kit Installing or Updating the FCA Utilities Using the emlxu_install Script Although it is possible to install emlxu onto one or more clients from a server that procedure is not covered in this document refer to the Solaris documentation Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 3 Installation 19 DG EMULEX Installing the FCA Utilities and the OneCommand Manager Application Note If an earlier version of the emlxu utilities package is already installed on the system the emlxu_install script removes the old version before installing the new one Prerequisites Before installing the Emulex emlxu utilities package you must completely install e The Emulex Sun driver kit SUNWemlxs for Fibre Channel and Converged Network Adapters Procedure To install the utilities kit using the emlxu_install script 1 Untar the emlxu_kit lt version gt lt platform gt tar file tar xvf emlxu kit l
76. ndation Software SFS which is part of the SFS Leadville stack The module name for the Emulex FC driver and FCoE driver for Solaris SFS is emlxs This document also provides information about the Emulex Network Interface Card NIC driver for Solaris which is used to operate the NIC function of the Emulex OneConnect Universal Converged Network Adapter UCNA The module name for the NIC driver is oce To work with the drivers for Solaris the system administrators should be familiar with Solaris and have access to standard system information For the FC FCoE driver familiarity with Oracle Storage SFS FC and FCoE is essential For the NIC driver familiarity with the Emulex OneConnect UCNA and Ethernet networking is essential Abbreviations ACK acknowledgement ADISC Discover address ALPA arbitrated loop physical address API application programming interface BIU bus interface unit ELS extended link service FC Fibre Channel FCA Fibre Channel adapter FCF Fibre Channel fabric FCIO FC input output FC IP Fibre Channel over IP FCoE Fibre Channel over Ethernet FCSP Fibre Channel Security Protocol FCT Fibre Channel port provider module in Oracle COMSTAR stack FCTL Fibre Channel transport library HBA host bus adapter IOCB input output control block IOCTL input output control LACP Link Aggregation Control Protocol LPFC Light Pulse Fibre Channel man manual e g man pages MBOX mailbox MTU maximum transmission unit Emulex Driv
77. nly for lpfc conf file P009212 01A Rev A 37 DG EMULEX 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table Configuring the NIC Interface Table 7 1 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris Solaris emlxs emlxs OneCommand Related OneCommand Min Max Defaults and LPFC LPFC Min Max Default Property Description Property and Description Comments cr delay Min 0 cr delay Min 0 Setting this value can Max 63 Max 63 minimize CPU Default 0 Default 0 utilization by Description Specifies a count Description Specifies a reducing the number of milliseconds after which an count of milliseconds after Of interrupts that the interrupt response is which an interrupt driver generates to generated if the cr count has response is generated if the operating not been satisfied This value the cr count has not been System is set to 0 to disable the satisfied This value is set Coalesce Response feature as to 0 to disable the Coalesce default Response feature as default cr count Min 1 cr count Min 1 This property is often Max 255 Max 255 determined by your Default 1 Default 1 OEM This property Description Specifies a count Description Specifies a sets the number of of 1 0 completions after count of I O completions _ Os to be queued in which an interrupt response is after which an interrupt the operating generated This feature is response is generated This Sys
78. odaamesmiensacseyuaees EE EEEE 33 Creating a Virtual NIG sense ctwateerecontecenedermieewanauaeedaweeasaviodancendecavarcanivads 34 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table is sdienccecuscscvesscrsanad csaten scsasias dieasnisvackassen dessa ccanoesanienacsadetanicacnics 36 8 OMIKS LOGS siissccsseciascceceansdeavsesnrecacesadniusadearses qeeasexsiccievsaeddessaeadensaxeds 43 General SIGUAUIOINS sscoscacssendecsicechcwcsdtieasenelsedecacoeshisseatentiibesecssideacswesaeeacaus 43 MOSSAGOS fesisi scddc cies bacec sie sawbd Oe iuG bias E Waawedesees aan aeieeaewtwnn ies es 43 Severity Levels co cerciccdvcstacecavessaadecbeseedcsasde chides lia sexeseatvasacssaseautacy in iiaes 45 Message Log Example woicvius die uionkan dor eaisdesesuesieseriusbeoseesnt ace nisan i eis 45 Miscellaneous Events ccccc cece ce cceeeeeeeeeeeeeeeeeeeeeseesseseeeeseeeeeeeeeeesgegars 46 Driver EVONES is csc cccscceuaeecveveeseeeedues tre Tes TCK eTe TECEN CCEE NEVET ee evvees 47 HBA Initialization Events sssnsessssosssossossrossesssosssosesoseosseoseroseossesseeo 49 Memory Management Events ccscesscseceeeeecceeceeseeseeeeeeseeneeeseeseeeeeeeeees 51 Service Level Interface SLI Events ssssssssesssescsssecccssecssseseceseseessseeeo 53 Mailbox Events seissrisesvesssrirsruccerisi iresi nnr t eera oT AEE EEEE Enae 57 Node EVENS saccnsscscdicsd senndcedien e E E E sewed E E E as 59 HAK EVENS eaen ie A E E E AE
79. on The emlxadm Utility The emlxadm utility is used to change driver parameters through a local interactive or command line interface It can also be used for firmware updates on non Oracle branded devices For more information see the Solaris FCA Utilities User Manual The emlxdrv Utility The emlxdrv utility associates the Emulex emlxs Solaris SFS driver and the Solaris LPFC driver to the various models of Emulex FC and FCoE adapters The emlxdrv utility is used for binding associating the Emulex drivers to the various models of Emulex FC adapters If the driver binding configuration is changed the host system must be rebooted in order for the new configuration to take effect For more information see the Solaris FCA Utilities User Manual Installing the FCA Utilities and the OneCommand Manager Application The FCA utilities and the OneCommand Manager application are packaged together in one application kit tar file The FCA utilities are comprised of the emlxadm utility and the emlxdrv utility e Theemlxadm utility provides an interface to the FCIO interface provided by the Oracle Storage SFS e The emlxdrv utility temporarily associates or binds the Emulex emlxs Solaris SFS driver and the Solaris LPFC driver to the various models of Emulex FC Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 3 Installation 18 DG EMULEX Installing the FCA Utilities and the OneCommand Manager Application adapters dur
80. on MOD_TX Warning MAP FAILED Low System resources Repeat the operation that generated the log If the error log is generated again reboot the system Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A
81. ou must uninstall it before uninstalling the OneCommand Manager application 2 Run the uninstall script opt HBAnyware wsuninstall This script stops the OneCommand Manager application Web Launch Interface service daemons if they are running and removes all Web Launch related files from the host Uninstalling the Utilities Using the emlxu_remove Script You can uninstall the utilities kit using the emlxu_remove script If you do not have the emlxu_remove script and you do not have the original emlxu utilities kit tar file you must uninstall the emlxu package manually follow the instructions in Uninstalling the Utilities Package Manually on page 24 If you are updating the emlxu utilities to a newer version and you have the new utilities kit tar file you do not need to use the emlxu_remove script The emlxu_install script removes any old version as it installs the newer version see Installing or Updating the FCA Utilities Using the emlxu_install Script on page 18 for more details To uninstall the utilities package without updating them Note All emlxu files are removed 1 Go to the directory where the emlxu_remove script is located or to the directory where the original utilities kit tar file is located by typing cd lt directory gt 2 If you have the emlxu_remove script skip to step 3 If you do not have the emlxu_remove script but you do have the original emlxu utilities kit tar file extract the emlxu_remove scrip
82. rming a resume operation Debug V DESCRI S M ESSAGE Lie Driver resume ACTION MSG ID No action needed 0131 ERROR Driver resume failed ERBOS E MASK LOG DRIVER 0x00000002 EV ERITY L PTION The driver was unable to resume due to some issue EV EL Error M DESCRI S M ESSAGE Driver failed F resum ACTION persis ur hardware and these errors to software configuration If problems Emulex technical support Check yo report ee HBA Initialization Events MSG_ID 0200 NOTICE Adapter initialization VERBOSE MASK LOG INIT 0x00000004 DESCRIPTION The adapter is initializing SEVERITY LEVEL Notice MESSAGE Adapter initialization ACTION No action needed MSG_ID 0201 ERROR Adapter initialization failed VERBOSE MASK LOG INIT 0x00000004 DESCRIPTION An attempt to initialize the adapter has failed SEVERITY LEVEL Error MESSAGE Adapter initialization failed Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX 8 emlxs Logs 5Q Messages ACTION Check your hardware configuration If problems persist report these errors to Emulex technical support MSG ID 0202 DEBUG Adapter initialization VERBOSE MASK LOG
83. s gt lt EMULEX eee MSG ID 1210 ERROR Stray IP completion VERBOSE MASK LOG IP 0x00001000 DESCRIPTION An IP sequence completion was received without issuing a corresponding IP sequence This error may indicate a driver or firmware problem SEVERITY LEVEL Error MESSAGE Stray IP completion ACTION No action needed If problems persist report these errors to Emulex technical support MSG _ ID 1211 DEBUG Abnormal IP completion ERBOSE MASK LOG IP 0x00001000 V DESCRIPTION An IP sequence completed with a status error in the IOCB The FC device on the network may not be responding S M EVERITY LEVEL Debug ESSAGE Abnormal IP completion ACTION No action needed If problems persist report these errors to your system administrator MSG_ID 1220 DEBUG Unsolicited IP dropped ERBOSE MASK LOG_IP 0x00001000 V DESCRIPTION An unsolicited IP sequence was received but was dropped for some reason S M EVERITY LEVEL Debug ESSAGE Unsolicited IP dropped ACTION No action needed MSG ID 1221 DEBUG IP recvd ERBOSE MASK LOG IP 0x00001000 EVERITY LEVEL Debug ESSAGE IP recvd ACTION No action needed V DESCRIPTION An unsolicited IP sequence was received S M MSG_ID 1230 ERROR Invalid IP sequence found
84. s the node is ready to be opened or it has been offline too long and needs to be flushed S M EVERITY LEVEL Debug ESSAGE Node timeout ACTION No action needed Link Events MSG_ID 0700 DEBUG Link event VERBOSE MASK LOG SLI 0x00000010 or LOG LINK 0x00000080 Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX 8 emlxs Logs 61 Messages DESCRIPTION A link event has occurred SEVERITY LEVEL Debug MESSAGE Link event ACTION No action needed MSG_ID 0710 NOTICE Link down EVERITY LEVEL Notice ESSAGE Link down VERBOSE MASK LOG LINK 0x00000080 DESCRIPTION The FC link is down to the adapter S M ACTION Check your network connections If problems persist report these errors to your system administrator MSG_ID 0720 NOTICE Link up EVERITY LEVEL Notice ESSAGE Link up ACTION No action needed MSG ID 0721 NOTICE NPIV Link up EVERITY LEVEL Notice ESSAGE NPIV Link up ACTION No action needed MSG ID 0730 NOTICE Link reset EVERITY LEVEL Notice ESSAGE Link reset ACTION No action needed VERBOSE MASK LOG LINK 0x00000080 DESCRIPTION The FC link is up S M VERBOSE MASK LOG LINK 0x00000080 DESCRIPTION The FC l
85. se adisc 0 Off If there are tape I Os for all FCP target devices 1 On devices on the SAN at link down Default 0 that support FCP2 1 Partial support Flushes I O s for non FCP2 target devices at link down 2 Full support Holds active I Os for all devices at link down Default 1 Description Sets the level of driver support for the FC ADISC login I O recovery method Description Controls the ELS command used for address authentication during rediscovery upon link up The driver always uses ADISC for FCP 2 devices and re discovery due to an registered state change notification RSCN set the use adisc property to 1 and the adisc support property to 1 partial support or 2 full support assign alpa Min 0x00 Max 0xef Default 0x00 valid ALPA s only Description This is only valid if the topology is loop A zero setting means no preference If multiple adapter instances on the same host are on the same loop set this value differently for each adapter Emulex Drivers for Solaris FC and FCoE version 2 70i assign alpa Description Sets a preferred ALPA for the adapter This parameter is only valid if the topology is loop P009212 01A Rev A gt EMULEX 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table Configuring the NIC Interface Table 7 1 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris emlxs One
86. t from the tar file by typing tar xf emlxu_kit lt version gt sparc tar emlxu_remove 3 Remove the emlxu utilities package by typing emlxu_remove The script locates the EMLXemlxu utilities package and the following message is displayed lt Removing EMLXemlxu package gt Note If no package is installed the following message is displayed pkgrm ERROR no package associated with lt EMLXemlxu gt You are prompted to remove the package with the following message Do you want to remove this package y n q Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 3 Installation 24 DG EMULEX Uninstalling the FCA Utilities and the OneCommand Manager Application 4 Enter lt y gt The following message is displayed Removal of lt EMLXemlxu gt was successful The script performs some cleanup and displays the following message lt Removing emlxu scripts gt lt emlxu_remove complete gt The utilities package is removed If you want to install another version of the emlxu utilities package do so now by following the instructions in one of the following sections e Installing or Updating the FCA Utilities Using the emlxu_install Script on page 18 e Installing or Updating the Utilities Package Manually on page 21 For additional information on installing and removing packages refer to the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manual pages
87. t tag This may change from one driver version to another emlxs0 identifies that the message is coming from the emlxs driver instance zero This changes from one driver instance to another NOTICE identifies the emlxs message severity level This may change from one driver version to another 720 identifies the emlxs drive message id This does not change from one driver version to another Link up identifies the actual error or event message This does not change from one driver version to another 1 Gb s fabric identifies additional information specific to the error or event message This information is normally intended for technical support engineering use This may change from one driver version to another Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A Emulex Drivers for Solaris FC and FCoE version 2 70i DG EMULEX Miscellaneous Events MSG ID 0001 DEBUG ERBOSE MASK LOG MISC 0x00000001 EVERITY LEVEL Debug ESSAGE None ACTION No action needed Gl MSG ID 0002 NOTICE ERBOSE MASK LOG MISC 0x00000001 EVERITY LEVEL Notice ESSAGE None ACTION No action needed MSG ID 0003 WARNING ERBOSE MASK LOG MISC 0x00000001 V DESCRIPTION This is a general purpose warning message S M EVERITY LEVEL Warning ESSAGE None ACTION No action needed MSG ID 0
88. t version gt lt platform gt tar The emlxu_install script is available Install the FCA utilities by typing emlxu_install The script prompts you to remove any earlier versions of the emlxu utilities package If an earlier package is not found this fact is indicated skip to step 6 The following text is displayed lt Removing old EMLXemlxu package gt If an old package is installed you are prompted to remove it Do you want to remove this package y n q Enter lt y gt The following message is displayed Removal of lt EMLXemlxu gt was successful The script expands the utilities kit tar file and begins installing the new package A message similar to the following is displayed lt Expanding emlxu_kit lt version gt sparc tar gt lt Adding new package gt The script installs the emlxu utilities package The package is prepared for installation and you are prompted for confirmation by the following message Do you want to continue with the installation of lt EMLXemlxu gt yrn Enter lt y gt The installation progress is indicated Examine the output for any errors or warnings If the installation is successful the following message is displayed near the end of the process Installation of lt EMLXemlxu gt was successful The script performs some cleanup and returns the following messages lt Cleaning directory gt lt emlxu_install complete gt lt Execute emlxu_re
89. t with some I O packets s still not completed The driver attempts to recover by i S M tself EVERITY LEVEL Notice ESSAGE Packet flush timeout ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0930 NOTICE Packet transport failed ERBOSE MASK LOG_PKT 0x00000200 V DESCRIPTION An attempt to send an I O packet failed The I O packet is retried by the upper layer S M EVERITY LEVEL Notice ESSAGE Packet transport failed ACTION No action needed MSG_ID 0931 ERROR Packet transport error ERBOSE MASK LOG_PKT 0x00000200 V DESCRIPTION An error occurred while attempting to send an I O packet The I O packet is likely to be failed back to the user application S M EVERITY LEVEL Error ESSAGE Packet transport error ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0932 DEBUG Packet transport Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX EVERITY L 8 emlxs Logs 66 Messages ERBOSE MASK LOG PKT 0x00000200 ESCRIPTION This message provides additional information about a EV EL Debug V D packet being sent S M ESSAGE Pac ket transport ACTION No action needed
90. tae eter ccraiaceadenanetusaaadutaudsateemhsdumedu mune a weteeade ce E OE RESE 18 Installing or Updating the FCA Utilities Using the emlxu_install Script 18 PRERCQUISICCS sroin snes nae EEEE Ea EE EEEE EEA 19 Procede ssnsdin ee vccsedvnin deea an ade eaa aeai o iaaa 19 Installing the OneCommand Manager Application with Web Launch 20 PREG QUISICOS ois saccvncteine scene Corie nas seaesebaduveewiaceceseseeeetesendve edecsebbdeescesassucceoss 20 PROCCOUIG ioiic s sceseccies sic eane dentamasledale EEEE E EEEE 21 Installing or Updating the Utilities Package Manually ccccceeeseeeeeeeeeeees 21 COMpatibility ccceccceeescceeeeccontecssnsccovnaccensncestaccevnscnsndscesnscceunacssuttesnnacceuns 21 PERC QUISICCS ic cscscceesscsicenn ctcedeesssaciewecadenesssiseeesusiesisemanseialswseweassderwcies cic cawesecle 21 Proced re 55 sdinescGoeceddeninces occese a sGeduccteiasdecvesadeeenescendacvesessesasvinectnecrmedes cous 22 Uninstalling the FCA Utilities and the OneCommand Manager Application 22 Uninstalling the OneCommand Manager Application ccc eeee eee ee eeeeeeeeeee 22 Uninstalling the OneCommand Manager Application with Web Launch Only 23 Uninstalling the Utilities Using the emlxu_remove SCript ccece eee eee eee eeeee 23 Uninstalling the Utilities Package Manually cce cee eee eee eeeeeeeeesneeeeeeeees 24 Emulex Drivers for Solaris FC and
91. tailed Mailbox events MSG_SLI_DETAIL 0x80000000 Detailed HBA SLI events MSG_ALL_MSG OXFFFFFFFF Detailed Node events Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs 45 DG EMULEX Messages Severity Levels Table 8 3 Severity Levels Level Message Description DEBUG Informational This message provides engineering debug information NOTICE Informational This message provides a general purpose information WARNING This message provides a general purpose warning ERROR This message indicates that a driver error has occurred PANIC Severe This message indicates that the driver has forced a system panic to occur Message Log Example The following is an example of a message on the system console 5 0336 emlxs0 NOTICE 720 Link up 1Gb fabric The following is an example of the same message in the system message log var adm messages file Jan 19 14 45 36 sunv240 emlxs ID 349649 kern info 5 0336 emlxs0 NOTICE 720 Link up 1Gb fabric In the above system log message Jan 19 14 45 36 identifies the date and time when the error or event occurred sunv240 identifies the name of the host machine emlxs identifies the message that came from the Emulex emlxs driver ID 349649 kern info identifies a Solaris specific message ID and kernel message level This changes from one driver message to another 5 0336 identifies the emlxs driver message contex
92. tem s driver disabled if cr delay is set to 0 feature is disabled if before an interrupt is cr delay is set to 0 initiated The driver default settings are roughly a 1 1 1 0 to interrupt ratio If you change this property performance varies per application link speed 0 auto select link speed O auto select This property can be 1 1Gb s 1 1Gb s changed to a specific link speed to 2 2 Gb s 2 2 Gb s optimize the link 4 4 Gb s 4 4 Gb s initialization process 8 8 Gb s 8 8 Gb s for a specific Range 0 8 Range 0 8 environment Default 0 Default 0 Description Sets the link Description Sets link speed setting for initializing speed the FC connection Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 38 gt EMULEX 7 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table Configuring the NIC Interface Table 7 1 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris emlxs OneCommand Property log notices Solaris emlxs OneCommand Min Max Defaults and Description Min 0x00000000 Max OXFFFFFFFF Default 0x0000000 Verbose mask for notice messages to the messages file Related LPFC Property log verbose LPFC Min Max Default and Description Min 0x0 Max Oxffff Default 0x0 bit mask When set to nonzero this property causes LPFC to generate additional messages concerning the state of the driver and
93. tion interrupt S M MSG_ID 0411 DEBUG State change VERBOSE MASK LOG SLI 0x00000010 DESCRIPTION The adapter has changed state S M EVERITY LEVEL Debug ESSAGE State change ACTION No action needed MSG ID 0412 DEBUG Link Up atten ERBOSE MASK LOG SLI 0x00000010 EVERITY LEVEL Debug ESSAGE Link Up atten ACTION No action needed V DESCRIPTION The adapter has triggered a link up attention interrupt S M MSG _ ID 0413 DEBUG Link Down atten VERBOSE MASK LOG SLI 0x00000010 DESCRIPTION The adapter has triggered a link down attention interrupt Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 8 emlxs Logs 54 DG EMULEX Messages SEVERITY LEVEL Debug MESSAGE Link Down atten ACTION No action needed MSG_ID 0420 ERROR Adapter hardware error ERBOSE MASK LOG SLI 0x00000010 V DESCRIPTION An interrupt has occurred and the status register indicates a nonrecoverable hardware error S M EVERITY LEVEL Error ESSAGE Adapter hardware error ACTION This error usually indicates a hardware problem with the adapter Try running adapter diagnostics If problems persist report these errors to Emulex technical support MSG ID 0421 NOTICE Adapter temperatur
94. ue gt lt interface gt Use dladm to show the current value of the private or unlisted driver parameters S gt dladm show linkprop p lt property name gt lt interface gt The following are private parameters provided by the driver e tx_rings e tx_ring_size e tx_bcopy_limit e tx_reclaim_threshold e rx_rings e rx_rings_per_group e rx_ring_size e rx_bcopy_limit e log_level Creating a Virtual NIC To create a virtual NIC vNIC use the dladm utility with the create vnic option For example dladm create vnic 1 netO vnicl Once a vNIC is created it can be assigned to a zone using the zonecfg utility For example zonecfg z zonel Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A DG EMULEX zonecfg zonecfg zonecfg zonecfg zonecfg zonecfg zonecfg zonecfg zonecfg zonel zonel gt 6 Configuring the NIC Driver 35 Configuring the NIC Interface No such zone configured create zonel gt zonel gt zonel gt zonel gt zonel gt zonel gt zonel gt set zonepath export zonel create add net set physical vnicl set address 192 168 1 100 verify commit Up to 63 VLANs can be used with each universal multichannel UMC virtual channel For information on configuring UMC refer to the Emulex Universal Multichannel Reference Guide Considerations e UMC can be configured using the OCM application CLI For more information refer to the One
95. ust be executed from a console On reboot you are presented with a set of UI based data entry forms that facilitate the required change in configuration dladm Support on Solaris 11 1 To configure the interface on Solaris 11 1 Use dladm to configure the interface and also perform a runtime update of the following driver parameters e MTU to change the MTU in Solaris 11 1 unplumb the interface and execute S gt dladm set linkprop p mtu 9000 lt interface gt where interface is net lt 0 1 2 gt Emulex Drivers for Solaris FC and FCoE version 2 70i P009212 01A Rev A 6 Configuring the NIC Driver 34 DG EMULEX Configuring the NIC Interface To see the plumbed interfaces execute gt ifconfig a e _tx_bcopy_limit this can be changed at runtime by executing gt dladm set linkprop p _tx bcopy limit lt value in bytes gt lt interface gt Note _tx_bcopy_limit is the same as the oce_bcopy_limit parameter in the oce conf file Using dladm the following tunable driver parameters are provided along with their usage e tx ring size gt dladm set linkprop p _tx ring size lt values between 256 and 2048 gt lt interface gt or gt dladm set linkprop p tx ring size lt values less than tx ring size gt lt interface gt e rx bcopy limit gt dladm set linkprop p rx bcopy limit lt value in bytes gt lt interface gt e log_level gt dladm set linkprop p _log_ level lt val
96. y descdesbcewncsceasatedeavacacossumennanee denen EEES 13 2 Important CONSIGETALIONS viccsciessdvciesvcnnnsdccsdaseawansaadanssenaerecasdecedenseecnsicanen 15 Known ISSUES wvcnincdcnunedaciceutvinccadanxaeanetnckwces dite narsacatsaustiansivessstduaseumsane eens 15 Driver Information EMIXS and oce ccccccecccceccccccccccsccceccccessccecssceessceesees 15 PREFEQUISILES ois cccic swteisiec rerit it renari BRE EEE eab wed necad see ewaneeteneedwee vane taveneaus 15 Compatibilty ie ccszesvicceirsaasecudoe cuca cssecuva sceseeutuadaeiegseetesieieeadearteucuvieees 15 SS Installation snan aa aaiae 16 Installing the Driver siscsccsusetadsadmescodaweasoxedebeenswacandiiwcnicanmatuneseseavsecateeoausess 16 Downloading and Installing the Driver for Solaris 11 1 SPARC X64 0005 16 Uninstalling the Drivers iss ccssecccssdecvesccccccasccsss socecegasvsebssteesideavtesssGcesvesses tees 16 FC FCOE Driver and NIC Driver sosciicscetescacsaccdedeceseceesceenscsacecueuseeeceessen tenes 16 Utilities ccnaemececadweinescccaweansdanaamtsenconanantaveacuveatanceuntaaesdeenaneoeneseeeneeandecsawancs 17 The OneCommand Manager Application ccccesccccccescccceeessccceeeeseasoes 17 The emlxadm Utility eessseseessescecosscscsesccesescecsseesosssceesesecossesossseeesesse 17 Theemlxdry ACY serienn ae awedn enea a EELE EEEE EEEE E EE A 17 Installing the FCA Utilities and the OneCommand Manager Application 17 PROCES ic c
97. y levels and an extensive listing of message IDs and descriptions are also provided Log messages are logged to the var adm messages system file Table 8 1 lists the types of notices warnings and error logging levels you may see Table 8 1 Notice Warnings and Error Types Default Min Effect of Changing Related Ipfc Driver Driver Property Max Default Property console notices 0 Sets the verbose level for log only when set to 0 log driver notices to the console messages are logged to the A system log file and also console warnings 0 Sets the verbose level for printed on the console driver warnings to the console Default Disabled console errors 0 Sets the verbose level for driver errors to the console log notices Oxffffffff Sets the verbose level for log verbose when set to driver notices to the system non zero verbose messages log file are generated log warnings Oxffffffff Sets the verbose level for driver warnings to the system Default Disabled log file log errors Oxffffffff Sets the verbose level for driver errors to the system log file Table 8 2 lists the types of log messages that can be logged to the system file Table 8 2 Log Message Types LOG Message Verbose flags Verbose Bit Verbose Description MSG_DISABLED 0x00000000 Always off MSG_MISC 0x00000001 Miscellaneous events MSG_DRIVER 0x00000002 Driver attach and detach events Emulex Drivers

Emulex Drivers for Solaris User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents