Home

Emulex Drivers for Solaris

1. The Apld can also be referenced in the kernel drv Ipfc conf file Example To configure fcp bind WWPN 200400a0b816dc52 Ipfc3t4 type cfgadm c configure c6 200400a0b816dc52 10 Edit the etc vfstab file and replace the sd pathname for example c3t4d1s6 to the ssd pathname for example c6t200400A0B816DC52d1s6 Migrating a Configuration with FC Boot Prerequisite e An additional Oracle branded Emulex adapter or Emulex adapter that is supported by emlxs and of a different family from the boot adapter with FCode version 1 50a4 or later and enabled Emulex Drivers for Solaris User Manual Page 21 gt G EMULEX Procedure To manually migrate 1 2 Back up all data and system disks Note current LPFC target and LUN information contained in the following files e etc vfstab e kernel drv lpfc conf e kernel drv sd conf Using Emulex s OneCommand Manager application for LPFC bundled as part of the driver kit available on the Emulex website 1 e Update the FCode in all adapters to the latest version e Verify that FCode is enabled Install the required emlxs driver package and patch Follow the instructions in the Installing the Solaris SFS FCA emlxs Driver section under Downloading and Installing the Driver for Solaris 10 SPARC x64 and x86 on page 2 Shut down the system with the shutdown command Install the new adapter Boot the OS If you are migrating the boot adapter to an Emulex adapter per
2. kernel drv sd conf 3 Using Emulex s OneCommand Manager application for LPFC bundled as part of the driver kit available at http www emulex com support solaris index jsp e Update the FCode in all adapters to the latest version e Verify that FCode is enabled 4 Uninstall the OneCommand Manager application and LPFC as follows Login as root or su to root then type Emulex Drivers for Solaris User Manual Page 20 gt G EMULEX pkgrm OneCommand lpfc 5 Install the required emlxs driver package and patch Follow the instructions in the Installing the Solaris SFS FCA emlxs Driver section under Downloading and Installing the Driver for Solaris 10 SPARC x64 and x86 on page 2 6 Install Emulex s utilities kit for emlxs available at http www emulex com support solaris sfs_sparc jsp Boot to the ok prompt Issue the Emulex FCode set sfs boot command to change the Emulex adapter s device path from LPFC to emlx The change does not take effect until the system is reset Example 0 ok show devs pci 8s 600000 1pfc 2 0 ok pci 8 600000 1lpfc 2 select dev Space required 0 ok set sfs boot 0 ok unselect dev Repeat this step for all adapters in the system Type reset all then boot the system to the oper ating system 9 Configure any targets that were used with the LPFC driver To return the target list type cfgadm a To configure the Apld s storage type cfgadm c configure lt ApId gt
3. 12 Issue the Emulex FCode set sfs boot command to change the remaining Emulex adapters device paths from LPFC to emlxs Changes do not take effect until the system is reset Example 0 ok show devs pci s 600000 1pfce 2 0 ok pci 8 600000 1lpfc 2 select dev Space required 0 ok set sfs boot 0 ok unselect dev Repeat this step for each of the remaining adapters in the system Type reset al1 then boot the system to the OS 13 Boot the new device s For a Oracle branded boot adapter 0 ok boot pci s 600000 SUNW emlxs 2 fp 0 0 disk w21000004cf 720664 0 a s For an Emulex boot adapter 0 ok boot pci 8 600000 em1x 2 fp0 0 disk w21000004cf720664 0 a 14 Use emlxdrv to migrate the remaining LPFC attached adapters to emlxs Emulex Drivers for Solaris User Manual Page 23 15 16 17 18 gt lt EMULEX Configure any targets that were used with the LPFC driver To return the target list type cfgadm a To configure the Apld s storage type cfgadm c configure lt ApId gt The Apld can also be referenced in the kernel drv Ipfc conf file Example To configure fcp bind WWPN 200400a0b816dc52 Ipfc3t4 type cfgadm c configure c6 200400a0b816dc52 Edit the etc vfstab file and replace the sd pathname for example c3t4d1s6 to the ssd pathname for example c6t200400A0B816DC52d1s6 Uninstall the OneCommand Manager application and the LPFC driver as follows Login as root or su to roo
4. Emulex Drivers for Solaris User Manual Page 46 gt G EMULEX MSG_ID 0520 DEBUG Mailbox error VERBOSE_MASK LOG_MBOX 0x00000020 DESCRIPTION An unsupported or illegal mailbox command was completed This error may indicate a driver or firmware problem SEVERITY LEVEL Debug MESSAGE Mailbox error ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0530 ERROR Mailbox timeout VERBOSE_MASK LOG_MBOX 0x00000020 DESCRIPTION The firmware did not response a mailbox command This error may indicate a hardware or firmware problem SEVERITY LEVEL Error MESSAGE Mailbox timeout ACTION No action needed If problems persist report these errors to Emulex technical support Node Events MSG_ID 0600 DEBUG Node create VERBOSE_MASK LOG_NODE 0x00000040 DESCRIPTION A node has been created for a remote device SEVERITY LEVEL Debug MESSAGE Node create ACTION No action needed MSG_ID 0601 DEBUG Node opened VERBOSE_MASK LOG_NODE_DETAIL 0x02000000 DESCRIPTION A node has been opened for IO transport SEVERITY LEVEL Debug MESSAGE Node opened ACTION No action needed MSG _ID 0602 NOTICE Node create failed VERBOSE_MASK LOG_NODE 0x00000040 DESCRIPTION A node create request for a remote device has failed SEVERITY LEVEL Notice MESSAGE Node create failed ACTION No action needed MSC ID 0603 DEBUG Node updated VERBOSE_MASK LOG_NOD
5. MESSAGE Packet flush timeout ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0930 NOTICE Packet transport failed VERBOSE_MASK LOG_PKT 0x00000200 DESCRIPTION An attempt to send an I O packet failed The I O packet is retried by the upper layer SEVERITY LEVEL Notice MESSAGE Packet transport failed ACTION No action needed MSG_1ID 0931 ERROR Packet transport error VERBOSE_MASK LOG_PKT 0x00000200 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 SEVERITY LEVEL Error MESSAGE Packet transport error ACTION No action needed If problems persist report these errors to Emulex technical support MSC ID 0932 DEBUG Packet transport VERBOSE_MASK LOG_PKT 0x00000200 DESCRIPTION This message provides additional information about a packet being sent SEVERITY LEVEL Debug MESSAGE Packet transport ACTION No action needed Emulex Drivers for Solaris User Manual Page 52 gt G EMULEX MSG_ID 0940 DEBUG Packet completion error VERBOSE_MASK LOG_PKT 0x00000200 DESCRIPTION An I O packet was completed with an error status This can occur during normal operation SEVERITY LEVEL Debug MESSAGE Packet completion error ACTION No action needed If problems persist report these errors to Emulex technical support FCP Traffic Events MSG_ID 1000 DEBUG Str
6. Migrating Automatically 000 0 ee 19 PrerequiSites ccccccccceccceeeeeeeeeeeeeeeeeeeeeeeeeeeaaeaaaeeeeeeeeeeaaeaeeeeeeeeeeesaaeees 19 Things to Know Before You Migrate creer eeeeeeeeeeereeeeees 20 Blue le TE 20 EIER UGGS teas e Eed en 20 Migrating a Configuration with FC Boot 21 Emulex Drivers for Solaris User Manual Page iii gt G EMULEX reteO WISELER EN Procedurer aina a AA A 22 Configuring the NIC Driver 24 Configuring the NIC Interface cc cececcectseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaaaaaaeenetees 25 PIOVCQUISIES ouine ai a Aa AAA AAAA AAE A ANAA AAAA ENA 25 PTOCCO HE EE 25 dladm Support on Solaris 171 26 Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table 27 Console and Log Messages aaseseseseeeeeeeeeeeeeeeseeeseeeeeeaeaeaeeaeeaeaaaaaeaaaaaaaaaaaaaaaaaaaaaaaaae 34 E Aa e LEERE PE IPE CP PE CEPT CEPT CPP IPE EPAI EPEA eT rer IPE Per errr PEII EPEA EP E errr 34 General Situations ccccccceeceecec cece eeeeeeeeeeeeeeaaeeeeeeeeeeeeeaaaaeeeeeeeeeeseaaaeeeeeeeees 34 MESSE Ee 34 Severity Level eens 36 Message Log Example siirre iiiaae 36 Miscellaneous Events ccccceecceceeeeeeeeeeeeeeeeecaaaeeeeeeeeaaaaaeeeeeeeeseeeeenaas 37 Drive E EE 38 HBA Initialization Events 40 Memory Management Events 41 Service Level Interface SLI Events 42 MalIDOX dE 46 Node Events edd 47 LinKk Events ee ee ee EE EN eg 48 ELS Evens eebe niles See 49 G
7. login I O recovery method 1 Partial support Flush I O s for non FCP2 target devices at link down 0 No support Flush active I O s for all FCP target devices at link down 2 Full support Hold active I O s for all devices at link down 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 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 Emulex Drivers for Solaris User Manual Page 13 Table 1 emlxs conf Parameters Continued gt lt EMULEX Property Name Default Min Max Activation Comments cr delay 63 Link reset This property specifies a count of milliseconds after which an interrupt response generated if cr count has not been satisfied T
8. Channel Fabric Events MSG_ID 1800 DEBUG FCF VERBOSE_MASK DESCRIPTION This message provides general information about the driver s FCF interface SEVERITY LEVEL Debug MESSAGE FCF ACTION No action needed MSG_ID 1801 DEBUG FCF detail VERBOSE_MASK DESCRIPTION This message provides detailed information about the driver s FCF interface SEVERITY LEVEL Debug MESSAGE FCF detail ACTION No action needed MSG_ID 1810 DEBUG FCF error VERBOSE_MASK DESCRIPTION An error was found while processing an FCF request SEVERITY LEVEL Debug MESSAGE FCF error ACTION No action needed MSG_ID 1820 DEBUG FCF state VERBOSE_MASK DESCRIPTION An FCF object state is changing SEVERITY LEVEL Debug MESSAGE FCF state ACTION No action needed MSG_ID 1820 DEBUG FCF event VERBOSE_MASK DESCRIPTION An FCF event has occurred SEVERITY LEVEL Debug MESSAGE FCF event ACTION No action needed Emulex Drivers for Solaris User Manual Page 62 oce Logs gt G EMULEX The logs are generated based on the MOD_MASK and Severity listed in the following tables See Configuring the NIC Driver on page 24 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
9. DEBUG IP recvd VERBOSE_MASK LOG_IP 0x00001000 DESCRIPTION An unsolicited IP sequence was received SEVERITY LEVEL Debug MESSAGE IP recvd ACTION No action needed Emulex Drivers for Solaris User Manual Page 54 ZS EMULEX MSG_ID 1230 ERROR Invalid IP sequence found VERBOSE_MASK LOG_IP 0x00001000 DESCRIPTION An IP sequence was found with an invalid code SEVERITY LEVEL Error 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 VERBOSE_MASK LOG_SFS 0x00002000 DESCRIPTION This message provides general information about the driver s SFS interface SEVERITY LEVEL Debug MESSAGE SFS ACTION No action needed MSG_ID 1301 DEBUG SFS detail VERBOSE_MASK LOG_SFS_DETAIL 0x20000000 DESCRIPTION This message provides detailed information about the driver s SFS interface SEVERITY LEVEL Debug MESSAGE SFS detail ACTION No action needed MSG_ID 1310 WARNING Diagnostic error VERBOSE_MASK LOG_SFS 0x00002000 DESCRIPTION A diagnostic request did not complete because of some issue SEVERITY LEVEL Warning MESSAGE 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 An ECHO diagnostic has completed SEVERITY
10. LEVEL Debug MESSAGE ECHO diagnostic completed ACTION No action needed MSG_ID 1312 WARNING ECHO diagnostic failed VERBOSE_MASK LOG_SFS 0x00002000 DESCRIPTION An ECHO diagnostic has failed to return a positive result This may indicate a connectivity problem with your FC network SEVERITY LEVEL Warning MESSAGE ECHO diagnostic failed ACTION Check your network connections If problems persist report these errors to your system administrator Emulex Drivers for Solaris User Manual Page 55 gt G EMULEX MSG_ID 1313 DEBUG BIU diagnostic completed VERBOSE_MASK LOG_SFS 0x00002000 DESCRIPTION A BIU diagnostic has completed SEVERITY LEVEL Debug MESSAGE BIU diagnostic completed ACTION No action needed MSG_ID 1314 ERROR BIU diagnostic failed VERBOSE_MASK LOG_SFS 0x00002000 DESCRIPTION A BIU diagnostic has failed to return a positive result This is usually caused by an adapter hardware problem SEVERITY LEVEL Error MESSAGE 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 SEVERITY LEVEL Debug MESSAGE POST diagnostic completed ACTION No action needed MSG_ID 1316 ERROR POST diagnostic failed VERBOSE_MASK LOG_SFS 0x00002000 DESCRIPTION A POST diagnostic has failed to return a positive result This is usually caused by an adapter
11. Sets the verbose level for log only when set to 0 log driver notices to the messages are logged to the console system log file and also printed on the console console warnings 0 Sets the verbose level for driver warnings to the Default Disabled console console errors 0 Sets the verbose level for Oxf ffffff Sets the verbose level for driver notices to the system log file driver errors to the console log warnings Oxffffffff Sets the verbose level for driver warnings to the system log file log errors Oxffffffff Sets the verbose level for driver errors to the system log file log verbose when set to non zero verbose messages are generated Default Disabled Table 5 lists the types of log messages that can be logged to the system file Table 5 Log Message Types LOG Message Verbose Verbose Bit Verbose Description Mask LOG_MISC 0x00000001 Miscellaneous events LOG_DRIVER 0x00000002 Driver attach and detach events Emulex Drivers for Solaris User Manual Page 34 Table 5 Log Message Types Continued gt G EMULEX LOG Message Verbose Verbose Description Mask Verbose Bit LOG INIT 0x00000004 HBA Initialization events LOG_MEM 0x00000008 Memory management events LOG_SLI 0x00000010 Service Level Interface SLI events LOG_MBOX 0x00000020 Mailbox events LOG_NOD
12. all the properties necessary to initialize the Emulex SFS FCA driver The emlxs conf driver properties are described in Table 1 on page 13 In the emlxs conf file all adapter specific properties have an emlxsxX prefix where X is the driver instance number For example setting emlxsO 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 Open the emlxs conf file in a text editor 2 Change the properties you want 3 Save the file See Table 1 on page 13 for activation requirements Enabling NPIV Support on Solaris 10 To enable NPIV support in the driver 1 Login as or su to root 2 Set enable npiv to 1 in the emlxs conf file Emulex Drivers for Solaris User Manual Page 10 gt G EMULEX 3 The fp driver properties are updated when the EMLXemlxu is installed Entries from 2 to 255 are added to the kernel drv fp conf file For example name fp class fibre channel port 0 name fp class fibre channel port 1 name fp class fibre channel port 2 name fp class fibre channel port 3 name fp class fibre channel port 4 name fp class fibre channel port 5 name fp class fibre channel port 6 name fp class fibre channel port 7 name fp class fibre channel port 8 name fp class fibre channel port 9 The first two lines are default You can add
13. 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 7 Log Messages in the NIC Driver Module Severity Message Recommended Action MOD_CONFIG Warning Failed to retrieve intr Unload the driver and types reload it MOD_CONFIG Warning Interrupt setup failed with Unload the driver and lt code gt reload it MOD_CONFIG Warning PCI initialization failed Unload the driver and with lt ret_code gt reboot the system MOD_CONFIG Warning Device Reset failed Unload the driver and reload it MOD_CONFIG Warning MAC registration failed Unload the driver and reload it MOD_CONFIG Warning Hardware initialization Unload the driver and failed with lt ret_code gt reload it Check the oce conf file to see if the parameters are correct MOD_CONFIG Warning Chip initialization failed Unload the driver and reload it Check the oce conf file to see if the parameters are correct MOD_CONFIG Note bmbx timed out Data communication with the hardware has broken down Reboot the system Emulex Drivers for Solaris User Manual Page 63 Table 7 Log Messages in the NIC Driver Continued gt G EMULEX Module Severity Message Recommended Action MOD_CONFIG Warning MBOX Command Failed Data communication with with Status lt code gt the hardware has broken down Reboot t
14. gt lt EMULEX Emulex Drivers for Solaris FC and FCoE version 2 60k NIC version 1 20g User Manual Emulex Connects P007708 01A Rev A Servers Storage and People gt G EMULEX Copyright 2003 2011 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 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 time a
15. hardware problem SEVERITY LEVEL Error MESSAGE POST diagnostic failed ACTION Contact Emulex technical support IOCTL Events MSG_ID 1400 DEBUG IOCTL VERBOSE_MASK LOG_IOCTL 0x00004000 DESCRIPTION This message provides general information about the driver s IOCTL interface SEVERITY LEVEL Debug MESSAGE IOCTL ACTION No action needed MSG_ID 1401 DEBUG IOCTL detail VERBOSE_MASK LOG_IOCTL_DETAIL 0x04000000 DESCRIPTION This message provides detailed information about the driver s IOCTL interface SEVERITY LEVEL Debug MESSAGE IOCTL detail ACTION No action needed Emulex Drivers for Solaris User Manual Page 56 ZS EMULEX MSG_ID 1410 DEBUG DFC VERBOSE_MASK LOG_IOCTL 0x00004000 DESCRIPTION This message provides general information about the driver s DFC interface SEVERITY LEVEL Debug MESSAGE DFC ACTION No action needed MSG_ID 1411 DEBUG DFC detail VERBOSE_MASK LOG_IOCTL_DETAIL 0x04000000 DESCRIPTION This message provides detailed information about the driver s DFC interface SEVERITY LEVEL Debug MESSAGE 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 MESSAGE DFC error ACTION No action needed Firmware Download Events MSG_ID 1500 DEBUG Firmware image VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESCRIPTION This
16. message provides general information about the firmware image SEVERITY LEVEL Debug MESSAGE Firmware image ACTION No action needed MSG _ID 1501 DEBUG Firmware detail VERBOSE_MASK LOG_FIRMWARE_DETAIL 0x10000000 DESCRIPTION This message provides detailed information about the firmware image SEVERITY LEVEL Debug MESSAGE Firmware detail ACTION No action needed MSG_ID 1502 NOTICE Firmware Library VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION This message shows the versions of firmware contained in the driver s library SEVERITY LEVEL Notice MESSAGE Firmware library ACTION No action needed Emulex Drivers for Solaris User Manual Page 57 gt G EMULEX MSG_ID 1510 ERROR Bad firmware image VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESCRIPTION A bad firmware image was provided to the download function SEVERITY LEVEL Error MESSAGE 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 VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESCRIPTION The firmware image provided was not compatible with the existing hardware SEVERITY LEVEL Error MESSAGE Firmware image not compatible ACTION Obtain the proper image file If problems persist report these errors to Emulex technical support MSG_ID 1520 NOTICE Firmware download VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESC
17. port 2 to 9 to support up to 10 virtual ports The port number of each entry must be in order with no gaps in between 4 Reboot the system To create delete and list virtual ports after a system reboot refer to the OneCommand Manager Application User Manual Enabling NPIV Support on Solaris 11 To enable NPIV support in the driver 1 Login as or su to root 2 Set enable npiv to 1 in the emlxs conf file this is set to 0 by default 3 Reboot the system If enable npiv is already set do not reboot 4 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 e You cannot delete a virtual port with a mounted 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 Oracle VM for x86 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
18. 0 log Mim Ost Max 0xFFFFFFFF verbose Max Oxffff Default 0x0000000 Default 0x0 Verbose mask for notice bit mask When set to messages to the messages nonzero this property file 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 warnings Min 0x00000000 log Mim Ost Max 0xFFFFFFFF verbose Max Oxffff Default 0x0000000 Default 0x0 Verbose mask for warning bit mask When set to messages to the messages nonzero this property file 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 Min 0x0 Max 0xFFFFFFFF verbose Max Oxffff Default 0x0000000 Default 0x0 Verbose mask for error bit mask When set to messages to the messages nonzero this property file 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 max xfer size Min 131072 N A Emulex Drivers for Solaris User Manual Page 30 gt lt EMULEX Table 3 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris emlxs OneCommand Property Solaris emlxs OneCommand Min Max Defaults and Description Related LP
19. 01 DESCRIPTION A driver event is being queued SEVERITY LEVEL Debug MESSAGE Event queued ACTION No action needed MSC ID 0012 DEBUG Event dequeued VERBOSE_MASK LOG_MISC 0x00000001 DESCRIPTION A driver event is being dequeued SEVERITY LEVEL Debug MESSAGE Event dequeued ACTION No action needed Driver Events MSG_ID 0100 NOTICE Driver attach VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION The driver is performing an attach operation SEVERITY LEVEL Notice MESSAGE 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 SEVERITY LEVEL Error MESSAGE Driver attach failed ACTION Check your hardware and software configuration If problems persist report these errors to Emulex technical support MSG _ID 0102 DEBUG Driver attach VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION The driver is performing a attach operation SEVERITY LEVEL Debug MESSAGE Driver attach ACTION No action needed MSG_ID 0110 NOTICE Driver detach VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION The driver is performing a detach operation SEVERITY LEVEL Notice MESSAGE Driver detach ACTION No action needed Emulex Drivers for Solaris User Manual Page 38 gt G EMULEX MSG_ID 0111 ERROR Driver detach failed VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTIO
20. 0424 WARNING Adapter warning VERBOSE_MASK LOG_ SLI 0x00000010 DESCRIPTION An interrupt has occurred indicating a recoverable adapter error SEVERITY LEVEL Warning MESSAGE 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 VERBOSE_MASK LOG_ SLI 0x00000010 DESCRIPTION A recoverable adapter error has occurred SEVERITY LEVEL Error MESSAGE 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 VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION The adapter has provided general information about the adapter s async status SEVERITY LEVEL Notice MESSAGE 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 SEVERITY LEVEL Debug MESSAGE 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 SEVERITY LEVEL Debug MESSAGE Ring error ACTION No action needed Emulex Drivers for Solaris User Manual Page 44 gt G EMULEX MSG_ID 0432 DEBUG Ri
21. 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 the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manual pages Emulex Drivers for Solaris User Manual Page 9 gt G EMULEX Configuration FC FCoE Configuration and Migration 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 provided by Emulex or by manually performing a set of procedures Changing Driver Properties Using the emlxs conf File The emlxs conf file contains
22. E 0x00000040 DESCRIPTION A node has been updated for a remote device SEVERITY LEVEL Debug MESSAGE Node updated ACTION No action needed Emulex Drivers for Solaris User Manual Page 47 gt G EMULEX MSG_ID 0610 DEBUG Node destroy VERBOSE_MASK LOG_NODE 0x00000040 DESCRIPTION A node has been destroyed for a remote device SEVERITY LEVEL Debug MESSAGE Node destroy ACTION No action needed MSG_ID 0611 DEBUG Node closed VERBOSE_MASK LOG_NODE_DETAIL 0x02000000 DESCRIPTION A node has been temporarily closed for IO transport SEVERITY LEVEL Debug MESSAGE Node closed ACTION No action needed MSG_ID 0612 NOTICE Node missing VERBOSE_MASK LOG_NODE 0x00000040 DESCRIPTION An FCP2 device node has been found missing SEVERITY LEVEL Notice MESSAGE Node missing ACTION No action needed MSG_1ID 0620 DEBUG Node not found VERBOSE_MASK LOG_NODE 0x00000040 DESCRIPTION There was an attempt to send an I O pkt to an unknown 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 VERBOSE_MASK LOG_NODE 0x00000040 DESCRIPTION The node timer expired This means the node is ready to be opened or it has been offline too long and needs to be flushed
23. E 0x00000040 Node events LOG_LINK 0x00000080 Link events LOG_ELS 0x00000100 ELS events LOG_PKT 0x00000200 General UO packet events LOG_FCP 0x00000400 FCP traffic events LOG_FCT 0x00000800 FCP target mode events LOG_IP 0x00001000 IP traffic events LOG_SFS 0x00002000 Solaris SFS events LOG_IOCTL 0x00004000 IOCTL events LOG_FIRMWARE 0x00008000 Firmware download events LOG_CT 0x00010000 CT events LOG_FCSP 0x00020000 FCSP events LOG_RESERVED 0x007C0000 Reserved for future use LOG_FCT_DETAIL 0x00800000 Detailed FCT events LOG_FCSP_DETAIL 0x01000000 Detailed FCSP events LOG_NODE_DETAIL 0x02000000 Detailed node events LOG_IOCTL_DETAIL 0x04000000 Detailed IOCTL events LOG_IP_DETAIL 0x08000000 Detailed IP events LOG_FIRMWARE_DETAIL 0x10000000 Detailed Firmware events LOG_SFS_DETAIL 0x20000000 Detailed Solaris SFS events LOG_MBOX_DETAIL 0x40000000 Detailed Mailbox events LOG_SLI_DETAIL 0x80000000 Detailed HBA SLI events LOG_ALL_MSG OXFFFFFFFF Detailed Node events Emulex Drivers for Solaris User Manual Page 35 gt lt EMULEX Severity Levels Table 6 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 driv
24. EX Table 1 emlxs conf Parameters Continued Property Default Min Max Activation Comments Name vport Solaris 10 only Virtual port registration table The enable npiv must be set to 1 The vport table may have any number of comma delimited entries Each entry must be of the form PHYS_WWPN VPORT_WWNN VPORT_WWPN VPORT_ID PHYS_WWPN World Wide Port Name of adapter s physical port VPORT_WWNN Desired World Wide Node Name of virtual port VPORT_WWPN Desired World Wide Port Name of virtual port VPORT_ID Desired virtual port ID 1 to max vports The port IDs must start at 1 and increment by 1 with no gaps in the count The virtual port ID 0 is reserved for the physical port Example vport 10000000c9123456 28010000c9123456 20010000c9123456 1 40000000c9123456 28020000c9123456 20020000c9123456 2 40000000c9123457 28010000c9123457 20010000c9123457 1 40000000c9123457 28020000c9123457 20020000c9123457 2 40000000c9123457 28030000c9123457 20030000c9123457 3 All entries are automatically created or removed by the OneCommand Manager application vport restrict login 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 initiator ports on the SAN Also rejects logins from other ports in the SAN because it assumes that all ports that send a PLOGI are Initiators When this par
25. FC Property LPFC Min Max Default and Description Comments network on Min 0 Disables Max 1 Enables Default 1 Description Enables or disables IP networking support in the driver network on Min 0 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 num iocbs Min 128 Max 10240 Default 1024 Description Sets the number of iocb buffers to allocate num iocbs Min 128 Max 10240 Default 256 Description Specifies the number of command buffers to allocate These buffers are used for Fibre Channel Extended Link Services ELS and one for each FCP command 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 Max 512 Default 512 Description Number of FC nodes NPorts the driver supports N A N A Emulex Drivers for Solaris User Manual Page 31 SG EMULEX Ta
26. ION 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 SEVERITY LEVEL Debug MESSAGE ELS sent ACTION No action needed Emulex Drivers for Solaris User Manual Page 49 gt G EMULEX MSG_ID 0801 DEBUG ELS comp VERBOSE_MASK LOG_ELS 0x00000100 DESCRIPTION An ELS command completed normally SEVERITY LEVEL Debug MESSAGE ELS comp ACTION No action needed MSG_ID 0810 ERROR Stray ELS completion VERBOSE_MASK LOG_ELS 0x00000100 DESCRIPTION The ELS command completion was received without issuing a corresponding ELS command This error may indicate a driver or firmware problem SEVERITY LEVEL Error MESSAGE 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 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 chec
27. LEX MSG_ID 1130 DEBUG FCT API VERBOSE_MASK DESCRIPTION This message provides an API trace with the driver s FCT interface SEVERITY LEVEL Debug MESSAGE FCT API ACTION No action needed IP Traffic Events MSG_ID 1200 DEBUG IP detail VERBOSE_MASK LOG_IP_DETAIL 0x08000000 DESCRIPTION This message provides detailed information about the driver s IP interface SEVERITY LEVEL Debug MESSAGE IP detail ACTION No action needed 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 VERBOSE_MASK LOG_IP 0x00001000 DESCRIPTION An IP sequence completed with a status error in the IOCB The FC device on the network may not be responding SEVERITY LEVEL Debug MESSAGE Abnormal IP completion ACTION No action needed If problems persist report these errors to your system administrator MSG_ID 1220 DEBUG Unsolicited IP dropped VERBOSE_MASK LOG _IP 0x00001000 DESCRIPTION An unsolicited IP sequence was received but was dropped for some reason SEVERITY LEVEL Debug MESSAGE Unsolicited IP dropped ACTION No action needed MSG_ID 1221
28. N The driver was unable to detach due to some issue SEVERITY LEVEL Error MESSAGE 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 VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION The driver is performing a detach operation SEVERITY LEVEL Debug MESSAGE Driver detach ACTION No action needed MSG_ID 0120 DEBUG Driver suspend VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION The driver is performing a suspend operation SEVERITY LEVEL Debug MESSAGE Driver suspend ACTION No action needed MSG_1ID 0121 ERROR Driver suspend failed VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION The driver was unable to suspend due to some issue SEVERITY LEVEL Error MESSAGE Driver suspend failed ACTION Check your hardware and software configuration If problems persist report these errors to Emulex technical support MSG_ID 0130 DEBUG Driver resume VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION The driver is performing a resume operation SEVERITY LEVEL Debug MESSAGE Driver resume ACTION No action needed MSG_ID 0131 ERROR Driver resume failed VERBOSE_MASK LOG_DRIVER 0x00000002 DESCRIPTION The driver was unable to resume due to some issue SEVERITY LEVEL Error MESSAGE Driver resume failed ACTION Check your hardware and software configuration If
29. 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 lt version gt lt platform gt tar The emlxu_install script is available 2 Install the FCA utilities by typing emlxu_install The script removes any earlier version 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 Emulex Drivers for Solaris User Manual Page 4 gt G EMULEX 3 Ifan old package is installed you are prompted to remove it Do you want to remove this package y n q 4 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 sim ilar 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
30. RIPTION An attempt to download a firmware image has occurred SEVERITY LEVEL Notice MESSAGE Firmware download ACTION No action needed MSG_ID 1521 NOTICE Firmware download complete VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESCRIPTION An attempt to download a firmware image was successful SEVERITY LEVEL Notice MESSAGE Firmware download complete ACTION No action needed MSG_ID 1522 ERROR Firmware download failed VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESCRIPTION An attempt to download a firmware image failed SEVERITY LEVEL Error MESSAGE Firmware download failed ACTION Check your hardware configuration If problems persist report these errors to Emulex technical support MSG_ID 1523 WARNING Firmware updated VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESCRIPTION New firmware has been updated on the adapter SEVERITY LEVEL Warning MESSAGE Firmware updated ACTION A reboot or adapter power cycle is required to activate the new firmware Emulex Drivers for Solaris User Manual Page 58 gt G EMULEX MSG_ID 1530 DEBUG Firmware dump VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESCRIPTION A firmware core dump has occurred SEVERITY LEVEL Debug MESSAGE Firmware dump ACTION Check your hardware configuration If problems persist report these errors to Emulex technical support MSG_ID 1540 WARNING Firmware update required VERBOSE_MASK LOG_FIRMWARE 0x00008000 DESCRIPTION A firmwa
31. SCRIPTION This message provides detailed information about the driver s FCSP interface SEVERITY LEVEL Debug MESSAGE FCSP detail ACTION No action needed MSG_ID 1702 DEBUG FCSP error VERBOSE_MASK LOG_FCSP 0x00020000 DESCRIPTION An error was found while processing a DFC request SEVERITY LEVEL Debug MESSAGE FCSP error ACTION No action needed MSG_ID 1705 DEBUG FCSP state VERBOSE_MASK LOG_FCSP 0x00020000 DESCRIPTION An authentication state is changing SEVERITY LEVEL Debug MESSAGE FCSP state ACTION No action needed MSG_ID 1706 DEBUG FCSP event VERBOSE_MASK LOG_FCSP 0x00020000 DESCRIPTION An authentication event has occurred SEVERITY LEVEL Debug MESSAGE FCSP event ACTION No action needed MSG_ID 1707 DEBUG FCSP status VERBOSE_MASK LOG_FCSP 0x00020000 DESCRIPTION An authentication status is being updated SEVERITY LEVEL Debug MESSAGE FCSP status ACTION No action needed MSG_ID 1710 DEBUG FCSP start VERBOSE_MASK LOG_FCSP 0x00020000 DESCRIPTION Authentication is being started to a specific node SEVERITY LEVEL Debug MESSAGE FCSP start ACTION No action needed Emulex Drivers for Solaris User Manual Page 61 ZS EMULEX MSG_ID 1720 DEBUG FCSP comp VERBOSE_MASK LOG_FCSP 0x00020000 DESCRIPTION Authentication is being stopped or completed to a specific node SEVERITY LEVEL Debug MESSAGE FCSP comp ACTION No action needed FCF Fibre
32. SEVERITY LEVEL Debug MESSAGE Node timeout ACTION No action needed Link Events MSG _ID 0700 DEBUG Link event VERBOSE_MASK LOG_ SLI 0x00000010 or LOG_LINK 0x00000080 DESCRIPTION A link event has occurred SEVERITY LEVEL Debug MESSAGE Link event ACTION No action needed Emulex Drivers for Solaris User Manual Page 48 ZS EMULEX MSG_ID 0710 NOTICE Link down VERBOSE_MASK LOG_LINK 0x00000080 DESCRIPTION The FC link is down to the adapter SEVERITY LEVEL Notice MESSAGE Link down ACTION Check your network connections If problems persist report these errors to your system administrator MSG_ID 0720 NOTICE Link up VERBOSE_MASK LOG_LINK 0x00000080 DESCRIPTION The FC link is up SEVERITY LEVEL Notice MESSAGE Link up ACTION No action needed MSG_ID 0721 NOTICE NPIV Link up VERBOSE_MASK LOG_LINK 0x00000080 DESCRIPTION The FC link is up for all virtual ports SEVERITY LEVEL Notice MESSAGE NPIV Link up ACTION No action needed MSG _ID 0730 NOTICE Link reset VERBOSE_MASK LOG_LINK 0x00000080 or LOG_SFS 0x00002000 DESCRIPTION An issue has forced the FC link to be reset SEVERITY LEVEL Notice MESSAGE Link reset ACTION No action needed MSG _ID 0731 ERROR Link reset failed VERBOSE_MASK LOG_LINK 0x00000080 or LOG_SFS 0x00002000 DESCRIPTION An attempt to reset the FC link has failed SEVERITY LEVEL Error MESSAGE Link reset failed ACT
33. a to files Verifies that the system boot device is not an Emulex adapter if so the sample script exits with an explanation 6 Obtains and verifies the FCode version for each adapter in the system If the FCode version is not compatible the sample script errors then exits 7 Sets the FCode SFS bit to 1 on each adapter 8 Calls the operating system s add remove driver utility to configure etc driver_aliases 9 Prompts you to reboot the system Emulex Drivers for Solaris User Manual Page 18 56 EMULEX The adapterN migrate and targetN migrate files are generated by the start sample script These files verify the migration process Only attached and operational targets are migrated e adapterN migrate where N is the adapter number one file for each adapter primarily this file contains the adapter device path name to link LPFC adapters to emlxs adapters across a reboot e targetN migrate where N is the adapter number only adapters with targets configured have this file this file has target numbers and WWNs finish_emlxs_migration sh The finish_emlxs_migration sh sample script performs the following tasks 1 Cleans up any device dangling links by running the operating system utility devfsadm C 2 Performs the following tasks for each adapter in the system a Reads the device name from the file that was generated by start_emlxs_migration sh b Greps with the Is l dev cfg command to acquire the emlxs cont
34. adapters use Oracle provided luxadm You can also use the OneCommand Manager application Refer to the OneCommand Manager Application User Manual for more information Oracle branded A Gb s adapters use the Emulex provided emlxadm tool which provides a download_fcode command syntax and details are provided in the Emulex FCA Utilities Reference Manual You can also use the OneCommand Manager application Refer to the OneCommand Manager Application User Manual for more information Emulex SFS supported 2 Gb s adapters use either luxadm or emlxadm You can also use the OneCommand Manager application Refer to the OneCommand Manager Application User Manual for more information Emulex SFS supported 4 Gb s adapters use emlxadm You can also use the OneCommand Manager application Refer to the OneCommand Manager Application User Manual for more information Emulex Drivers for Solaris User Manual Page 17 gt lt EMULEX Use Cases Note The concurrent production use of emlxs and LPFC on a single server is not supported Transient co existence is required in some migration use cases but must be discontinued before going into production Different use cases will result in different migration scenarios Table 2 Use Cases Server Existing LPFG Targeted FC Environment See Section Platform Configuration x64 and x86 Not applicable All cases SPARC Existing LPFC driver no emlxs no FC boot See Migra
35. ameter is turned off 0 the driver attempts to login to every port that it can access in the SAN and accept logins from all ports NOTE In a SAN where there are other initiators this feature greatly reduces the hardware resources the driver uses Emulex Drivers for Solaris User Manual Page 16 gt lt EMULEX Migrating from the Solaris LPFC Driver to the Solaris emlxs Driver If the Emulex LPFC driver for Solaris is already installed you can migrate to the Emulex emlxs driver either by customizing and running the unsupported sample scripts provided by Emulex or by manually performing a set of procedures These scripts are available on the SFS driver pages on the Emulex website Operational Behaviors of the emlxs Driver e Device Discovery Device masking in the emlxs driver is managed using the Solaris cfgadm utility e Firmware download Oracle branded adapters the emlxs driver includes the adapter firmware and overrides any firmware version previously residing on the adapter You cannot update the firmware manually Emulex SFS supported adapters the Emulex provided emlxadm tool provides a download_fw command Syntax and details are provided in the Emulex FCA Utilities Reference Manual You can also use the OneCommand Manager application Refer to the OneCommand Manager Application User Manual for more information e Universal Boot download including OpenBoot FCode Oracle branded 2 Gb s
36. atten VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION The adapter has triggered a link down attention interrupt SEVERITY LEVEL Debug MESSAGE Link Down atten ACTION No action needed MSC ID 0420 ERROR Adapter hardware error VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION An interrupt has occurred and the status register indicates a nonrecoverable hardware error SEVERITY LEVEL Error MESSAGE 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 temperature VERBOSE_MASK LOG_ SLI 0x00000010 DESCRIPTION The adapter has provided general information about the adapter s temperature SEVERITY LEVEL Notice MESSAGE Adapter temperature ACTION No action needed MSG_ID 0422 WARNING Adapter temperature VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION The adapter s temperature is too hot SEVERITY LEVEL Warning MESSAGE Adapter temperature ACTION Check hardware ventilation Reduce adapter usage Shut down the host system Emulex Drivers for Solaris User Manual Page 43 gt G EMULEX MSG_ID 0423 NOTICE Adapter notice VERBOSE_MASK LOG_ SLI 0x00000010 DESCRIPTION The adapter has provided general information about the adapter s condition SEVERITY LEVEL Notice MESSAGE Adapter notice ACTION No action needed MSG_ID
37. ay FCP completion VERBOSE_MASK LOG_FCP 0x00000400 DESCRIPTION An FCP command completion was received without issuing a corresponding FCP Command This error may indicate a driver or firmware problem SEVERITY LEVEL Debug MESSAGE Stray FCP completion ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 1001 DEBUG FCP completion error VERBOSE_MASK LOG_FCP 0x00000400 DESCRIPTION An FCP command completed with an error status These errors can occur during normal operation SEVERITY LEVEL Debug MESSAGE FCP completion error ACTION No action needed FCT Traffic Events MSG_ID 1100 DEBUG FCT detail VERBOSE_MASK LOG_FCT_DETAIL 0x00800000 DESCRIPTION This message provides detailed information about the driver s FCT interface SEVERITY LEVEL Debug MESSAGE FCT detail ACTION No action needed MSG_ID 1110 DEBUG FCT debug VERBOSE_MASK LOG_FCT 0x00000800 DESCRIPTION This message provides general information about the driver s FCT interface SEVERITY LEVEL Debug MESSAGE FCT debug ACTION No action needed MSG_ID 1120 DEBUG FCT error VERBOSE_MASK LOG_FCT 0x00000800 DESCRIPTION A general error has occurred in the driver s FCT interface SEVERITY LEVEL Debug MESSAGE FCT error ACTION No action needed If problems persist report these errors to Emulex technical support Emulex Drivers for Solaris User Manual Page 53 gt G EMU
38. ble 3 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris emlxs Solaris emlxs Related OneCommand OneCommand Min Max LPFC eee Comments Property Defaults and Description Property 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 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 Disable power management support in the driver topology 0 loop if it fails attempt pt topology 0x0 loop if it fails The topology to pt 2 pt to pt only 4 loop only 6 pt to pt if it fails attempt loop Default 0 Description Link topology for initializing the Fibre Channel connection Set pt to pt if you want to run as an N_Port Set loop if you want to run as an NL_Port attempt pt to pt 0x2 pt to pt only 0x4 loop only Default 0 Description Controls the FC topology expected by LPFC at boot time FC offers pt to pt fabric and arbitrated loop For the adapter to operate as an 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 T
39. ce 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 Fibre Channel 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 CNAs Refer to the OneCommand Manager Application User Manual for more information 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 The emlxdrv Utility The emlxdrv utility temporarily associates the Emulex emlxs Solaris SFS driver and the Solaris LPFC driver to the various models of Emulex Fibre Channel and FCoE adapters for use during migration from the Solaris LPFC driver to the Solaris SFS driver The emlxdrv utility is intended to be used for binding associating the Emulex emlxs Leadville Fibre Channel driver and the Emulex LPFC traditional non Leadville Fibre Channel driver to the various models of Emulex Fibre Channel adapters If the driver binding configuration is changed the host system must usually be rebooted in order for the new configuration to take effect Installing the FCA Utilities and the OneCommand Manager Application T
40. ckage Manual 6 Uninstalling the FCA Utilities and the OneCommand Manager Application 7 Uninstalling the OneCommand Manager Application a 7 Uninstalling the OneCommand Manager Application with Web i Launch ONY sssaaa 8 Uninstalling the Utilities Using the emlxu_remove Script 8 Uninstalling the Utilities Package Manual 9 CONGU rraca EEEE EEEE EEEE AE EEA 10 FC FCoE Configuration and Migration 0 i i nities 10 idee iere BE 10 Changing Driver Properties Using the emlxs conf File 10 Enabling NPIV Support on Solaris 10 10 Enabling NPIV Support on Solaris 1 11 NPIV Configuration Limits eessen 11 NPIV and OS Virtualization 20 0 0 2 ccceceeeeeeeeeee eee eeeeeeeeeeeeeeeaaeeeeeeeeeeeeeaeaeeees 11 Using VPorts with Oracle VM Server for SPARC Containers and Oracle VM Server for vn 12 Configuring Target Mode Support for Solaris 17 12 Emulex SFS FCA Driver Properties cccccceeeee cece eeeeeeeeeeeeeaaeeneeeeeeeeeeeaaaeees 12 The Configuration File eMIXS CONP ccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeaaeeeeeeeees 12 Migrating from the Solaris LPFC Driver to the Solaris emlxs Driver 17 Operational Behaviors of the emlxs Driver ceeeeeeeceeeeeeeeeeeeeeeeaeeeeees 17 Sample Script File Details 18 Start_emIxS_MigratiON Sh 2 00 2 eee cceeeeeeeeee cece ec aeeeeeeeeeecaeeeeeeeeeeeeeeeaaaaeeeeeeees 18 Tnieh emlvs migration ab 19 Migrating a Configuration without FC Boot 19
41. d if the Description This is only topology is loop valid if 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 User Manual Page 27 gt lt EMULEX Table 3 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris emlxs Solaris emlxs Related i OneCommand OneCommand Min Max LPFC SE Comments Property Defaults and Description Property console Min 0x00000000 log Mim Ost notices Max 0xFFFFFFFF verbose Max Oxffff Default 0x0000000 Default 0x0 Verbose mask for notice bit mask When set to messages to the console 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 Ipfc conf file console Min 0x00000000 log Mim Ost warnings Max 0xFFFFFFFF verbose Max Oxffff Default 0x0000000 Default 0x0 Verbose mask for warning bit mask When set to messages to the console 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 Ipfc conf file console errors Min 0Ox00000000 log Min 0x0 Max 0xFFFFFFFF verbose Max Oxffff Default 0x0000000 De
42. drv i pciex19a2 700 For a OneConnect OCE11102 UCNA add_drv i pciex19a2 710 Procedure To configure the NIC interface s 1 Plumb the interface ifconfig net lt X gt plumb where X is the interface number To see the interfaces created execute gt dladm show link This command lists all the interfaces in the system Emulex Drivers for Solaris User Manual Page 25 gt G EMULEX 2 Assign an IP address ifconfig net lt X 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 1 Perform the steps detailed in configuring the NIC interface in reverse order 2 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
43. e 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 available online in the opt HBAnyware README_WEBLAUNCH ttt 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 Emulex Drivers for Solaris User Manual Page 5 gt lt EMULEX e 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 file File Extension jnlp e The HTTP server must be running The system on which you are running the browser the client requires e Java must be installed The specific requirements are e Oracle s 32 bit Java 6 0 or later for Intel based systems x86 and IA64 e 32 bit Java 6 0 or later for x86 64 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 op
44. eneral I O Packet Events 51 RER 53 FCT Traffic Events ancii eraa a a E 53 IP Traffic Events 54 Solaris SFS Events 55 OCT BVGINS oenina iaaa aaaea eaaa aaa aa aaa a aaa aa 56 Firmware Download Events 57 Common Transport Events 59 FCSP Fibre Channel Security Protocol Events eee 60 FCF Fibre Channel Fabric Events 62 COL OOS e tae tne tnee cee ete eee ccc emern A ead ne ceed une ctced ne ceaetonunnaee 63 Emulex Drivers for Solaris User Manual Page iv gt lt EMULEX 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 Foundation 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 Important Considerations Known Issues See the product
45. ent on the system the install script attempts to remove them first install 5 When prompted enter the type of management you want to use 1 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 firmware 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
46. er has forced a system panic to occur Message Log Example The following is an example of a message on the system console 5 0336 emlxs0O 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 es Jan 19 14 45 36 unidentified the date and time when the error or event occurred e sunv240 identifies the name of the host machine e emlxs identifies the message came from the Emulex emlxs driver e ID 349649 kern info identifies a Solaris specific message ID and kernel message level This changes from one driver message to another e 5 0336 identifies the emlxs driver message context tag This may change from one driver version to another e emlxs0 identifies the message is coming from the emlxs driver instance zero This changes from one driver instance to another e NOTICE identifies the emlxs message severity level This may change from one driver version to another e 720 identifies the emlxs drive message id This does not change from one driver version to another e Link up identifies the actual error or event message This does not change from one driver version to another e 1 Gb s fabric identifies additional information specific to the error or event message This information is normally
47. erly in the new emlxs environment Limitations e If an Emulex adapter is the boot adapter the sample script exits without proceeding with migration e If an Emulex adapter is configured to use the IP over FC interface the IP interface does not migrate to the emlxs environment Procedures To automatically migrate from LPFC to emixs 1 Download the migrate tar file to the host system in which the LPFC driver is in control and untar it The tar file contains two sample script files and a subdirectory containing binary files that are used by the sample scripts 2 Open the tar file and view the start_emlxs_migration sh and finish_emlxs_migration sh sample script files Make changes to these files as needed based upon your system configuration 3 Login as root and run the start_emlxs_migration sh customized script file for details see page 18 After start_emlxs_migration sh is completed reboot the host system 4 Login as root and change directory cd to where the customized migration scripts are installed 5 Run the finish_emlxs_migration sh customized script file for details see page 19 6 Uninstall the OneCommand Manager application for the LPFC driver and install the OneCommand Manager application for the emlxs driver To manually migrate from LPFC to emlxs 1 Back up all data and system disks 2 Note current LPFC target and LUN information contained in the following files e etc vfstab e kernel drv Ipfc conf e
48. erties See the OneCommand Manager Application User Manual for more information about using the OneCommand Manager application with the Emulex SFS FCA driver e All properties are adapter specific Note If any of the default property values are changed verify that this change does not impact the migration before you migrate The Configuration File emIxs conf In the emlxs conf file all adapter specific parameters have emlxsX prefix where X is the driver instance number for example setting emlxsO link speed 4 makes 4 Gb s the default link speed 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 to the modload command For example modload kernel drv emlxs automap 0 for 32 bit platforms or modload kernel drv sparcv9 emlxs automap 0 for 64 bit platforms Emulex Drivers for Solaris User Manual Page 12 Table 1 emlxs conf Parameters gt lt EMULEX Property Name Default Min Max Activation Comments ackO Adapter reset Use ACKO for class 2 If ACKO is 1 the 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 Dynamic Sets the level of driver support for the FC ADISC
49. 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 DESCRIPTION An I O packet has timed out and is being aborted SEVERITY LEVEL Debug MESSAGE Packet timeout ACTION No action needed MSG_ID 0911 DEBUG CHANNEL watchdog VERBOSE_MASK LOG_PKT 0x00000200 DESCRIPTION I O s are getting stale waiting on a I O channel transmit queue SEVERITY LEVEL Debug MESSAGE 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 SEVERITY LEVEL Debug MESSAGE TXQ watchdog ACTION No action needed Emulex Drivers for Solaris User Manual Page 51 gt G EMULEX MSG_ID 0920 DEBUG Packet flush VERBOSE_MASK LOG_PKT 0x00000200 DESCRIPTION An I O packet is being flushed SEVERITY LEVEL Debug MESSAGE Packet flush ACTION No action needed MSC ID 0921 DEBUG Packet flushed VERBOSE_MASK LOG_PKT 0x00000200 DESCRIPTION An I O packet has been flushed SEVERITY LEVEL Debug MESSAGE Packet flushed ACTION No action needed MSG _ID 0922 NOTICE Packet flush timeout VERBOSE_MASK LOG_PKT 0x00000200 DESCRIPTION An I O packet flush request has timed out with some I O packets s still not completed The driver attempts to recover by itself SEVERITY LEVEL Notice
50. fault 0x0 Verbose mask for error messages to the console 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 Ipfc conf file Emulex Drivers for Solaris User Manual Page 28 G EMULEX u Table 3 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris emlxs Solaris emlxs Related i OneCommand OneCommand Min Max LPFC SE Comments Property Defaults and Description Property cr delay Min 0 cr delay Min 0 Setting this value Max 63 Max 63 can minimize CPU Default 0 Default 0 utilization by Description Specifies a Description Specifies a reducing the count of milliseconds after count of milliseconds number of which an interrupt response after which an interrupt interrupts that the is generated if the cr count response is generated if driver generates to has not been satisfied This the cr count has not been the operating value is set to 0 to disable satisfied This value is set system the Coalesce Response to 0 to disable the feature as default Coalesce Response feature as default cr count Min 1 cr count Min 1 This property is Max 255 Max 255 often determined Default 1 Default 1 by your OEM This Description Specifies a Description Specifies a property sets the count of I O completions coun
51. form the following additional steps Otherwise skip to step 8 a Identify the device path of the new boot drive using the following format format pci 8 600000 l1pfc 2 sd 1 0 b Use emlxdrv to change only the migrating LPFC attached adapter family to emlxs Do not migrate the boot LPFC adapter s family c Shutdown then boot the system to the ok prompt d Issue the set sfs boot command to change the migrated Emulex adapter device paths from LPFC to emlxs 0 ok show devs pci s 600000 1pfce 2 Emulex Drivers for Solaris User Manual Page 22 gt G EMULEX 0 ok pci 8 600000 lpfc 2 select dev Space required 0 ok set sfs boot 0 ok unselect dev Repeat this step for each of the migrated adapters in the system Type reset a11 then boot the system to the OS 8 Define or designate an alternate boot drive for DAS boot through SFS and the Oracle or Emulex adapter If the alternate boot drive is fabric attached configure the storage by using a command such as cfgadm c configure lt Apld gt 9 Use the format command to identify the alternate boot drive and take note of its path because it will be used to boot from the added adapter 10 Use the ufsdump and ufsrestore commands to create a fabric boot disk Follow the instructions until complete Refer to the Emulex boot code documentation for LightPulse adapters which is available on the Emulex website 11 Shut down the server and boot to the ok prompt
52. gned by the system SEVERITY LEVEL Error MESSAGE 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 system SEVERITY LEVEL Error 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 VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION This message provides vendor specific information about the adapter SEVERITY LEVEL Debug MESSAGE Vital Product Data ACTION No action needed MSG_ID 0410 DEBUG Link atten VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION The adapter has triggered a link attention interrupt SEVERITY LEVEL Debug MESSAGE Link atten ACTION No action needed Emulex Drivers for Solaris User Manual Page 42 gt G EMULEX MSG_ID 0411 DEBUG State change VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION The adapter has changed state SEVERITY LEVEL Debug MESSAGE State change ACTION No action needed MSG_ID 0412 DEBUG Link Up atten VERBOSE_MASK LOG_ SLI 0x00000010 DESCRIPTION The adapter has triggered a link up attention interrupt SEVERITY LEVEL Debug MESSAGE Link Up atten ACTION No action needed MSG _ID 0413 DEBUG Link Down
53. he auto topology settings 0 and 6 do not work unless the adapter is using firmware version 3 20 or higher property controls the protocol not physical topology attempted by the driver Emulex Drivers for Solaris User Manual Page 32 gt G EMULEX Table 3 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Solaris emlxs Solaris emlxs Related e OneCommand OneCommand Min Max LPFC SECH Comments Property Defaults and Description Property P 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 User Manual Page 33 Console and Log Messages emlxs Logs General Situations gt G EMULEX 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 This section describes the type of console and log messages you may see Security levels and an extensive listing of message IDs and descriptions are also provided Log messages are logged to the varladm messages system file Table 4 lists the types of notices warnings and error logging levels you may set Table 4 Notice Warnings and Error Types log notices Default Effect of Changing Driver Property Min Max Default Related Ipfc Driver Property console notices 0
54. he system MOD_CONFIG Warning Could not get msix System did not grant the vectors requested resources Reboot the system MOD_TX Warning wqb pool empty Cannot transmit data because driver is low on resources Check for process generating heavy traffic MOD_TX Warning wqm pool empty Cannot transmit data because driver is low on resources Check for process generating heavy traffic Emulex Drivers for Solaris User Manual Page 64
55. he 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 s The emlxadm utility provides an interface to the Fibre Channel input output 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 adapters during 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 to learn how to use these utilities The following must be installed before you can install the utilities e The Solaris FC FCoE driver version 2 50 or later e The NIC driver version 1 10 or later for NIC capability To install the FCA Utilities and the OneCommand Manager application 1 Copy the Solaris utility kit to a temporary directory on your system Emulex Drivers for Solaris User Manual Page 3 gt G EMULEX 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 Execute the install script to begin installation If the HBAnyware utility the OneCommand Manager Core or the OneCommand Manager Enterprise applications or the Solaris driver utilities are already pres
56. his value is set to 0 to disable the Coalesce Response feature as default enable npiv Adapter reset This property enables NPIV support in the driver 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 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 OxFFFFFFFF Dynamic Verbose mask for warning messages to the messages file log errors OxFFFFFFFF 0x00000000 OxFFFFFFFF Dynamic Verbose mask for error messages to the messages file max xfer size 339968 131072 1388544 Reboot This property sets the maximum SCSI transfer size in bytes per IO 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 suppor
57. ies kit tar file extract the emlxu_remove script 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 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 A e Installing or Updating the Utilities Package Manually on page 6 Emulex Drivers for Solaris User Manual Page 8 gt G EMULEX For additional information on installing and removing packages refer to the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manual pages Uninstalling the Utilities Package Manually To uninstall the emlxu utilities package
58. il VERBOSE_MASK LOG_SLI_ DETAIL 0x80000000 DESCRIPTION This message provides detailed information about an SLI event SEVERITY LEVEL Debug MESSAGE SLI detail ACTION No action needed MSG_ID 0461 ERROR SLI ERROR VERBOSE_MASK LOG_ SLI 0x00000010 DESCRIPTION This message provides error information about an SLI event SEVERITY LEVEL Error MESSAGE SLI ERROR ACTION No action needed MSG_ID 0421 DEBUG SLI DEBUG VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION This message provides debug information about an SLI event SEVERITY LEVEL Debug MESSAGE SLI DEBUG ACTION No action needed Mailbox Events MSG_ID 0500 DEBUG Mailbox event VERBOSE_MASK LOG_MBOX 0x00000020 DESCRIPTION A mailbox event has occurred SEVERITY LEVEL Debug MESSAGE Mailbox event ACTION No action needed MSG_ID 0501 DEBUG Mailbox detail VERBOSE_MASK LOG_MBOX_DETAIL 0x40000000 DESCRIPTION This message provides detailed information about a mailbox event SEVERITY LEVEL Debug MESSAGE Mailbox detail ACTION No action needed MSG_ID 0510 DEBUG Stray mailbox interrupt VERBOSE_MASK LOG_MBOX 0x00000020 DESCRIPTION A mailbox command completion interrupt was received and the mailbox is not valid This error may indicate a driver or firmware problem SEVERITY LEVEL Debug MESSAGE Stray mailbox interrupt ACTION No action needed If problems persist report these errors to Emulex technical support
59. intended for technical support engineering use This may change from one driver version to another Emulex Drivers for Solaris User Manual Page 36 gt G EMULEX Miscellaneous Events MSG_ID 0001 DEBUG VERBOSE_MASK LOG_MISC 0x00000001 DESCRIPTION This is a general purpose informational message SEVERITY LEVEL Debug MESSAGE None ACTION No action needed MSG_ID 0002 NOTICE VERBOSE_MASK LOG_MISC 0x00000001 DESCRIPTION This is a general purpose informational message SEVERITY LEVEL Notice MESSAGE None ACTION No action needed MSG_ID 0003 WARNING VERBOSE_MASK LOG_MISC 0x00000001 DESCRIPTION This is a general purpose warning message SEVERITY LEVEL Warning MESSAGE None ACTION No action needed MSG_ID 0004 ERROR VERBOSE_MASK LOG_MISC 0x00000001 DESCRIPTION This is a general purpose error message SEVERITY LEVEL Error MESSAGE None ACTION No action needed MSG_ID 0005 PANIC VERBOSE_MASK LOG_MISC 0x00000001 DESCRIPTION This is a general purpose panic message SEVERITY LEVEL Panic Severe MESSAGE None ACTION Contact Emulex technical support MSG_ID 0010 DEBUG Event VERBOSE_MASK LOG_MISC 0x00000001 DESCRIPTION This is debug information about a driver event SEVERITY LEVEL Debug MESSAGE Event ACTION No action needed Emulex Drivers for Solaris User Manual Page 37 ZS EMULEX MSG_ID 0011 DEBUG Event queued VERBOSE_MASK LOG_MISC 0x000000
60. ive SCSI driver and works in Solaris 10 Emulex s emlxs driver supports the Solaris FC stack using ssd as the SCSI driver With this procedure a SAN setup on the host seamlessly migrates from LPFC to the same setup using emlxs Prerequisites e SPARC server running Solaris 10 e Emulex s LPFC driver and associated application kit including the OneCommand Manager application installed on the host system e Emulex s emlxs driver SUNWemIxs installed on the host system Emulex Drivers for Solaris User Manual Page 19 gt lt EMULEX e Emulex FCode version 1 00p or later pre installed on all adapters Things to Know Before You Migrate e FC tape devices do not migrate to the emlxs environment Configure devices after migration e LPFC conf properties do not migrate into the emlxs driver environment Note custom configuration values before migration as default properties are used after migration Customize applicable properties after the migration completes e The Solaris FC stack does not support LUN level masking Verify that the system is properly configured to provide the same number of LUNs in emlxs as are contained in the original LPFC environment For a specific target any visible LUNs that are not configured in the LPFC environment are automatically configured into the emlxs environment e The Solaris FC stack natively supports mpxio If you use multipathing or load balancing software verify that the software functions prop
61. k the state of the remote PortlD MSG_ID 0820 DEBUG ELS rcvd VERBOSE_MASK LOG_ELS 0x00000100 DESCRIPTION An unsolicited ELS command was received SEVERITY LEVEL Debug MESSAGE ELS revd 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 SEVERITY LEVEL Debug MESSAGE Unsolicited ELS dropped ACTION No action needed MSG_ID 0822 DEBUG ELS reply VERBOSE_MASK LOG_ELS 0x00000100 DESCRIPTION A reply is being sent for an unsolicited ELS command SEVERITY LEVEL Debug MESSAGE ELS reply ACTION No action needed Emulex Drivers for Solaris User Manual Page 50 ZS EMULEX MSG_ID 0830 ERROR Invalid ELS command found VERBOSE_MASK LOG_ELS 0x00000100 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 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
62. lxu gt y n 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 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 EMLXemlxu 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 EMLXemIxu 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 you must uninstall it before uninstalling the OneCommand Manager application See Uninstalling the OneCommand Manager Application with Web Launch Only on page 8 1 2 Log on as root Run the OneCommand Manager uninstall script opt HBAnyware scripts uninstall Emulex Drivers for Solaris User Manual Page 7 gt lt EMULEX Uninstalling the OneCommand Manager Application with Web Launch Only 1 Log on as root Note If you installed the OneCommand Ma
63. mory pool error ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0311 DEBUG Memory pool alloc failed VERBOSE_MASK LOG_MEM 0x00000008 DESCRIPTION The driver was unable to allocate memory from one of its own memory pools SEVERITY LEVEL Debug MESSAGE 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 Emulex Drivers for Solaris User Manual Page 41 gt G EMULEX MSG_ID 0312 DEBUG Memory pool detail VERBOSE_MASK LOG_MEM 0x00000008 DESCRIPTION This message provides detailed information about memory buffer pool management SEVERITY LEVEL Debug MESSAGE Memory pool detail ACTION No action needed MSG_1ID 0320 NOTICE No unsolicited buffer available VERBOSE_MASK LOG_MEM 0x00000008 DESCRIPTION The driver s unsolicited buffer pool is exhausted The I O is dropped and is most likely retried by the remote device SEVERITY LEVEL Notice MESSAGE 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 to Emulex technical support MSC ID 0330 ERROR Invalid access handle VERBOSE_MASK LOG_MEM 0x00000008 DESCRIPTION The driver had an invalid access handle assi
64. nager application Web Launch Interface you must uninstall it before uninstalling the OneCommand Manager application 2 Execute the uninstallation 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 9 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 4 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 utilit
65. nd 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 Solaris driver pages of the Emulex website for compatibility between drivers and applications Emulex Drivers for Solaris User Manual Page 6 gt lt EMULEX Prerequisites If an 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 9 then return to this section to install the new utilities package Procedure To install the emlxu utilities package manually 1 2 Log in as root or su to 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 EMLXemixu 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 EMLXem
66. nd 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 User Manual Page ii gt G EMULEX laigo liro iTe a M 1 Important Considerations cccccceeeeeeeeeeeeeeeaeeeeeeeeeeeeeeaaaeeeeeeeeeeeesaaaaeeeeeeeseeeaaaeaees 1 KONM WE 1 Driver Information emlxs and Oce ii i iiiieieiereees 1 Prerequisites cceccceecccceeeeeeeeeeeeeeeeaeeaeeeeeeeeeeaaeaaeeeeeeeeeeaaaageeeeeeeeeasaaeees 1 elle Ui E 1 InstallatioMe aces aes ededed daed Aeaa deta daca date Aeaa dedadeds date dana dedaderadutedoandnateeaantes 2 Installing Au CET E 2 Downloading and Installing the Driver for Solaris 10 SPARC x64 and x86 2 Uninstalling the Driver 2 rte EE 3 The OneCommand Manager Application ccccccseeeeeeeeeeeeeeeeeeeaeeeees 3 The emlxadm Ulm 3 The embar Utility sorces 3 Installing the FCA Utilities and the OneCommand Manager Application 3 Installing or Updating the FCA Utilities Using the emlxu_install Script 4 Installing the OneCommand Manager Application with Web Launch 5 Installing or Updating the Utilities Pa
67. ng reset VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION An SLI ring is being reset SEVERITY LEVEL Debug MESSAGE Ring reset ACTION No action needed MSG_ID 0440 DEBUG Adapter msg VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION A message was sent to the driver from the adapter SEVERITY LEVEL Debug MESSAGE Adapter msg ACTION No action needed MSG_ID 0450 ERROR IOCB invalid VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION An IOCB was received from the adapter with an illegal value This error may indicate a driver or firmware problem SEVERITY LEVEL Error MESSAGE IOCB invalid ACTION No action needed If problems persist report these errors to Emulex technical support MSG_ID 0451 DEBUG IOCB queue full VERBOSE_MASK LOG_SLI 0x00000010 DESCRIPTION The IOCB queue is full This occurs during normal operation SEVERITY LEVEL Debug MESSAGE IOCB queue full ACTION No action needed MSG_ID 0452 DEBUG IOCB event VERBOSE_MASK LOG_ SLI 0x00000010 DESCRIPTION An IOCB local error event is being reported by the adapter SEVERITY LEVEL Debug MESSAGE IOCB event ACTION No action needed MG ID 0453 DEBUG IOCB stale VERBOSE_MASK LOG_ SLI 0x00000010 DESCRIPTION An IOCB completed after its associated packet completed SEVERITY LEVEL Debug MESSAGE IOCB stale ACTION No action needed Emulex Drivers for Solaris User Manual Page 45 ZS EMULEX MSG_ID 0460 DEBUG SLI deta
68. nicate SEVERITY LEVEL Debug MESSAGE Adapter offline ACTION No action needed Emulex Drivers for Solaris User Manual Page 40 gt G EMULEX MSG_ID 0231 WARNING Adapter shutdown VERBOSE_MASK LOG_INIT 0x00000004 DESCRIPTION The adapter has been shutdown and requires a reboot to reinitialize SEVERITY LEVEL Warning MESSAGE Adapter shutdown ACTION Contact Emulex technical support MSC ID 0240 ERROR Adapter reset failed VERBOSE_MASK LOG_INIT 0x00000004 DESCRIPTION An attempt to reset the adapter has failed SEVERITY LEVEL Error MESSAGE Adapter reset failed ACTION Check your hardware configuration If problems persist report these errors to Emulex technical support Memory Management Events MSG_ID 0300 DEBUG Memory alloc VERBOSE_MASK LOG_MEM 0x00000008 DESCRIPTION The driver allocated system memory SEVERITY LEVEL Debug MESSAGE Memory alloc ACTION No action needed MSG_ID 0301 ERROR Memory alloc failed VERBOSE_MASK LOG_MEM 0x00000008 DESCRIPTION The driver was unable to allocate system memory The system is low on memory resources SEVERITY LEVEL Error MESSAGE Memory alloc failed ACTION No action needed If problems persist report these errors to your system administrator MSG_ID 0310 ERROR Memory pool error VERBOSE_MASK LOG_MEM 0x00000008 DESCRIPTION A problem has occurred with the memory buffer pool management SEVERITY LEVEL Error MESSAGE Me
69. on these technologies to learn the best use of resources related to NPIV technology Emulex Drivers for Solaris User Manual Page 11 gt lt EMULEX Using VPorts with Oracle VM Server for SPARC Containers and Oracle VM Server for x86 Using NPIV with Oracle VM Server for SPARC formerly Logical Domains Solaris containers or Oracle VM Server for x86 formerly xVM user domains is simple 1 Create virtual ports for the domains containers to which you want to present dedicated storage 2 Discover and attach the targets to virtual ports 3 Assign the target 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 Target mode support is only available on FC HBAs To configure target mode support for Solaris 11 1 Login as or su to root 2 Set target mode to 1 in the emlxs conf file You can also set individual paths to target mode emlxsX 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 3 Uncomment the line ddi forceattach 1 4 Reboot the system To configure targets refer to the Oracle COMSTAR Administration document Emulex SFS FCA Driver Properties e The emlxs conf file contains all the properties necessary to initialize the Emulex SFS FCA driver e The OneCommand Manager application reflects the emlxs conf driver prop
70. pletion ACTION Check the physical connections to FC network and the state of the remote Port MSG_ID 1620 DEBUG CT revd VERBOSE_MASK LOG_CT 0x00010000 DESCRIPTION An unsolicited CT command was received SEVERITY LEVEL Debug MESSAGE CT rcvd ACTION No action needed MSG_ID 1621 DEBUG Unsolicited CT dropped VERBOSE_MASK LOG_CT 0x00010000 DESCRIPTION An unsolicited CT command was received and then dropped for some reason SEVERITY LEVEL Debug MESSAGE Unsolicited CT dropped ACTION No action needed MSG_ID 1622 DEBUG CT reply VERBOSE_MASK LOG_CT 0x00010000 DESCRIPTION A reply is being sent for an unsolicited CT command SEVERITY LEVEL Debug MESSAGE CT reply ACTION No action needed MSG _ID 1630 ERROR Invalid CT command found VERBOSE_MASK LOG_CT 0x00010000 DESCRIPTION A CT command was found with an invalid command code SEVERITY LEVEL 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 DEBUG FCSP VERBOSE_MASK LOG_FCSP 0x00020000 DESCRIPTION This message provides general information about the driver s FCSP interface SEVERITY LEVEL Debug MESSAGE FCSP ACTION No action needed Emulex Drivers for Solaris User Manual Page 60 gt G EMULEX MSG_ID 1701 DEBUG FCSP detail VERBOSE_MASK LOG_FCSP_DETAIL 0x01000000 DE
71. problems persist report these errors to Emulex technical support Emulex Drivers for Solaris User Manual Page 39 HBA Initialization Events MSC 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_1ID 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 gt G EMULEX ACTION Check your hardware configuration If problems persist report these errors to Emulex technical support MSG_ID 0202 DEBUG Adapter initialization VERBOSE_MASK LOG_INIT 0x00000004 DESCRIPTION The adapter is initializing SEVERITY LEVEL Debug MESSAGE Adapter initialization ACTION No action needed MSG_ID 0210 DEBUG Adapter transition VERBOSE_MASK LOG_INIT 0x00000004 DESCRIPTION The adapter is changing states SEVERITY LEVEL Debug MESSAGE Adapter transition ACTION No action needed MSG_1ID 0220 DEBUG Adapter online VERBOSE_MASK LOG_INIT 0x00000004 DESCRIPTION The adapter is online and ready to communicate SEVERITY LEVEL Debug MESSAGE Adapter online ACTION No action needed MSG_ID 0230 DEBUG Adapter offline VERBOSE_MASK LOG_INIT 0x00000004 DESCRIPTION The adapter is offline and unable to commu
72. prompted for confirmation by 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 6 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_remove when ready to uninstall gt 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 Manu ally on page 6 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 EMLXemI xu 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 EMLXemIxu man to the system environment s man path For further information on installing and removing packages refer th
73. re update is required on the adapter SEVERITY LEVEL Warning MESSAGE Firmware update required ACTION To trigger an automatic firmware download you must perform a manual adapter reset or link reset once 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 VERBOSE_MASK LOG_CT 0x00010000 DESCRIPTION A CT command is being sent SEVERITY LEVEL Debug MESSAGE CT sent ACTION No action needed MSG_ID 1601 DEBUG CT comp VERBOSE_MASK LOG_CT 0x00010000 DESCRIPTION A CT command completed normally SEVERITY LEVEL Debug MESSAGE CT comp ACTION No action needed MSG_ID 1610 ERROR Stray CT completion VERBOSE_MASK 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 MESSAGE Stray CT completion ACTION No action needed If problems persist report these errors to Emulex technical support Emulex Drivers for Solaris User Manual Page 59 gt G EMULEX MSG_ID 1611 DEBUG Abnormal CT completion VERBOSE_MASK LOG_CT 0x00010000 DESCRIPTION A CT command completed with a status error in the OCH The FC device on the network may not be responding The driver automatically retries this CT command if needed SEVERITY LEVEL Debug MESSAGE Abnormal CT com
74. release notes for the latest information Driver Information emlxs and oce Prerequisites One of the following operating systems must be installed Solaris 10 SPARC e Solaris 10 x64 and x86 e Solaris 11 x64 Compatibility 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 User Manual Page 1 56 EMULEX Installation Installing the Driver Downloading and Installing the Driver for Solaris 10 SPARC x64 and x86 The Solaris SFS FCA emlxs driver and the Solaris OneConnect UCNA oce driver are distributed by Oracle as part of the Solaris 10 operating environment with driver updates distributed as part of Solaris updates and patches If the Solaris SFS FCA emlxs driver and the Solaris OneConnect UCNA oce driver are not already installed obtain and install the Solaris 10 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 driver was already installed install the driver by obtaining and installing individual patches 1 From the Oracle website download the following required patches e For Solaris 10 SPARC s
75. roller number c Writes the LPFC controller number and the emixs controller number to the map file d Constructs a target device name using the target WWN format for example 3 21000004cf92913c for each target in the target file 3 Uses the cfgadm al command to grep the target device name output and determine if the target device is already configured Configures the device if necessary with the cfgadm c configure command 4 Greps with the etc vfstab command and replaces any LPFC based storage device entry with its new emlxs based storage device name entry using the target WWN device name format for example c3 21000004cf92913c 5 Executes a mountall if any LPFC storage device entry has been replaced with a new SFS storage device name Forces the operating system to re mount local devices with etc vfstab command The controllermap migrate and the Ipfccontroller migrate are map files that are generated by the finish sample script e controllermap migrate a file with entries that map the LPFC controller number to the emlxs controller number e Ipfccontroller migrate a file with entries that map the adapter LPFC controller numbers to the LPFC adapter numbers for etc vfstab parsing Migrating a Configuration without FC Boot Migrating Automatically Automatic migration provides an equivalent FC storage setup running on the Solaris FC stack Emulex s Solaris LPFC driver on the SPARC platform uses sd as the nat
76. s Related OneCommand OneCommand Min Max LPFC SE Comments Property Defaults and Description Property ack0 0 The driver uses ACK1 ackO 0 The driver uses ACK1 for class 2 for class 2 acknowledgement acknowledgement 1 The driver uses ACKO 1 The driver uses ACKO for class 2 for class 2 acknowledgement acknowledgement Range Min 0 Max 1 Range Min 0 Max Default 0 Default 0 Description Determines if Description Determines ACKO is used instead of if ACKO is used instead of ACK1 for class 2 ACK1 for class 2 acknowledgement acknowledgement adisc support 0 No support Flush active use adisc 0 Off If there are tape I Os for all FCP target 1 On devices on the devices at link down Default 0 SAN that support 1 Partial support Flush Description Controls the FCP2 set the use I O s for non FCP2 target ELS command used for adisc property to 1 devices at link down address authentication and the adisc 2 Full support Hold active during rediscovery upon support property to I Os for all devices at link link up The driver always 1 partial support down uses ADISC for FCP 2 or 2 full support Default 1 devices and re discovery Description Sets the level of due to an registered state driver support for the FC change notification ADISC login UO recovery RSCN method assign alpa Min 0x00 assign Description Sets a Max 0xef alpa preferred ALPA for the Default 0x00 valid AL DAS adapter This parameter only is only vali
77. t then type pkgrm OneCommand lpfc Install Emulex s utilities kit for emlxs which is available on the Emulex website 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 single lines 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 Driver on page 2 for more information The following parameters are configurable through the oce conf file oce_default_mtu The default MTU The Emulex UCNA supports 1500 and 9000 byte MTU sizes By default it is set to 1500 oce_fm_capability Sets the driver s fault management 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 Emulex Dri
78. t HBAnyware README_WEBLAUNCH txt for more setup information Procedure To install the OneCommand Manager application Web Launch Interface 1 2 Log on as root Navigate to the OneCommand Manager application directory Type cd opt HBAnyware Run the install script Type wsinstall When prompted enter the Web server s document root directory For example var apache htdocs 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 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 config uration files are created and Web Launch Service automatically starts To verify the installation locate another client open a Web browser window and enter this URL according to this format http P_ADDR PORT_NUM ocmanager jnlp where P_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 OneComma
79. t in the driver Emulex Drivers for Solaris User Manual Page 14 Table 1 emlxs conf Parameters Continued gt G EMULEX Property Name Default Min Max Activation Comments 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 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 ub bufs 1000 40 16320 Reboot This property sets the number of unsolicited buffers to be allocated target mode Reboot Solaris 11 only 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 topology 0 loop then P2P 2 P2P only 4 loop only 6 P2P then loop Link reset This property sets point to point mode if you want to run as an N_Port Set to loop mode if you want to run as an NL_Port Emulex Drivers for Solaris User Manual Page 15 gt G EMUL
80. t of I O completions number of I Os to after which an interrupt after which an interrupt be queued in the response is generated This response is generated operating system s feature is disabled if cr This feature is disabled if driver before an delay is set to 0 cr delay is set to 0 interrupt is initiated The driver default settings are roughly a 1 1 I O to interrupt ratio If you change this property performance varies per application link speed 0 auto select link speed 0 auto select This property can 1 1Gb S 2 2Gb S 4 4Gb S 8 8 Gb S Range 0 8 Default 0 Description Sets the link speed setting for initializing the FC connection 1 1 Gb S 2 2 Gb S 4 4 Gb S 8 8 Gb S Range 0 8 Default 0 Description Sets link speed be changed to a specific link speed to optimize the link initialization process for a specific environment Emulex Drivers for Solaris User Manual Page 29 gt lt EMULEX Table 3 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Continued Max 1388544 Default 339968 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 Solaris emlxs Solaris emlxs Related i OneCommand OneCommand Min Max LPFC SE Comments Property Defaults and Description Property log notices Min 0x0000000
81. 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 must 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 To configure the interface on Solaris 11 Use dladm to configure the interface and also perform runtime update of the following driver parameters e MTU to change the MTU in Solaris 11 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 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 Emulex Drivers for Solaris User Manual Page 26 gt lt EMULEX Solaris emlxs and Solaris LPFC Driver Properties Cross Reference Table The cross reference information listed in Table 3 refers to the driver for Solaris LPFC version 6 30 Table 3 Solaris emlxs and Solaris LPFC Driver Property Cross Reference Solaris emlxs Solaris emlx
82. ting a Configuration FC boot without FC Boot on page 19 Existing LPFC driver FC emlxs with FC boot See Migrating a Configuration boot with FC Boot on page 21 The unsupported sample migration scripts include support for migration in Oracle Cluster environments This revision does not cover migration of a boot drive or of logical unit numbers LUNs accessed through multipathing software such as EMC PowerPath or Symantec Veritas DMP or of volume managers such as Oracle SVM or Symantec VxVM Sample Script File Details Emulex provides unsupported sample scripts to help you migrate from the Solaris LPFC driver to the Solaris emlxs driver These scripts are available on the SFS driver pages on the Emulex website You can customize these scripts and run them to automate the migration process start_emlxs_migration sh The start_emlxs_migration sh sample script performs the following tasks 1 Verifies required packages are installed 3 packages LPFC driver emlxs driver and the OneCommand Manager application Cleans up any device dangling links by running the operating system utility devfsadm C Obtains and saves the following information for each adapter in the system e OS device name for the adapter i e reflects PCI path e OS logical controller number for the adapter e Obtains a target number and WWN for all targets configured for each adapter and obtains the number of LUNs configured for each target Writes dat
83. vers for Solaris User Manual Page 24 gt G EMULEX 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 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 default value is severity of CE_WARN and MOD_MASK comprising of all modules 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 dev 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_
84. ystems FC and FCoE protocols 145096 e For Solaris 10 x64 and x86 systems FC and FCoE protocols 145097 s For Solaris 10 SPARC systems NIC protocol 145098 s For Solaris 10 x64 and x86 systems NIC protocol 145099 2 Follow the instructions to install each patch Uninstalling the Driver To uninstall the driver 1 Remove the driver patch by typing patchrm lt patch_id gt For example patchrm 139609 04 The script performs the removal and returns the following messages Validating patches Loading patches installed on the system Done Checking patches that you specified for removal Done Approved patches will be removed in this order 139609 04 Checking installed patches Backing out patch 139609 04 Patch 139609 04 has been backed out For additional information on installing and removing patches see the Solaris system administration documentation and the patchadd 1M and patchrm 1M manual pages Emulex Drivers for Solaris User Manual Page 2 gt lt EMULEX Utilities Emulex provides three utilities to facilitate the configuration and use of the Solaris drivers s 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 emlxadm and a number of additional ones across multiple systems It offers a choice of a graphical user interface and a scriptable command line interfa

Emulex Drivers for Solaris

Contents

Download Pdf Manuals

Related Search

Related Contents