FCA Utilities User Manual
Contents
1. Example emlxadm gt clear_all Updating lpfs Cannot unload module emlxs Will be unloaded upon reboot Updating 800 Cannot unload module emlxs Will be unloaded upon reboot Updating 900 Cannot unload module lpfc Will be unloaded upon reboot Updating 980 Cannot unload module lpfc Will be unloaded upon reboot Updating fa0o0 Cannot unload module emlxs Will be unloaded upon reboot Updating f d00 Cannot unload module emlxs Will be unloaded upon reboot Updating fe00 Cannot unload module emlxs Will be unloaded upon reboot Updating fc00 Cannot unload module emlxs Will be unloaded upon reboot Updating fcl10 Cannot unload module emlxs Will be unloaded upon reboot Updating fc20 Cannot unload module emlxs Will be unloaded upon reboot Done The FCA Utilities User Manual Page 34 gt G EMULEX clear_dev lt alias gt Clears driver binding to the specified devices You must specify one of the adapter aliases listed on the screen Each alias is shared by multiple adapter models Driver bindings can be made only with an adapter alias and not with a specific adapter model You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt clear_dev fe00 Updating fe00 Cannot unload module emlxs Will be unloaded upon reb2. gt G EMULEX Installing the Utilities The Emulex utility programs are provided on the Emulex Web site You can download them by going to http www emulex com support solaris index jsp and selecting the appropriate Solaris SFS operating system version Then look for Utilities and click Download Compatibility The StorEdge SAN Foundation Software SFS driver and utilities support the following operating systems e Solaris 10 SPARC e Solaris 10 x64 and x86 The following table specifies the adapters supported by the Solaris SFS FCA emlxs driver and the Emulex Fibre Channel Adapter Utilities FCA Utilities Table 1 Adapter Compatibility FCA Utilities Adapter Solaris SFS Driver HBAnyware Utility emlxadm emlxdrv SG XPCIE20FC NEM Z N A SG XPCIE2FC ATCA Z N A SG XPCI1FC EM2 N A SG XPCI2FC EM2 N A SG XPCIE2FC EB4 Z X LP21002 lt LP21000 LPe12002 LPe12000 LP11002 LP11000 LPe11004 LPe11002 LPe11000 LP10000ExDC LP10000DC LP10000 LP9802 LP9002DC LP9002L LP9002S These utilities support the Fibre Channel FC component of converged network adapters CNAs such as the LP21000 and LP21002 These utilities do not support the Ethernet component of CNAs gt lt gt lt gt lt gt lt gt lt kk X gt lt X X X X X gt lt gt lt X X X X gt lt X X gt lt gt lt gt lt gt lt X lt X gt lt
3. GA_NXT CT_ACC Rsn 0 Exp 0 01011500 210000e0 ns Performs and returns a complete query of the fabric name server Example emlxadm gt ns Nameserver TYPE Lport PID 0113E1 WWPN 21000020371938fa PORT NAME SEAGATE ST39103FC 0004 WWNN 20000020371938fa NODE _ NAME null IPA f ELLELLELLELLLLLELE IP_ ADDR 0 0 0 0 CLASS Class3 FC4 TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 TYPE Lport PID 0113E2 WWPN 21000020371939a2 PORT NAME SEAGATE ST39103FC 0004 WWNN 20000020371939a2 NODE NAME null IPA f LfLELLLLLLLELLELE IP_ADDR 0 0 0 0 CLASS Class3 FC4 TYPES 00000100 00 The FCA Utilities User Manual 000000 00000000 00000000 00000000 00000000 00000000 00000000 Page 25 gt G EMULEX TYPE Lport PID 0113E4 WWPN 21000020371938a3 PORT NAME SEAGATE ST39103FC 0004 WWNN 20000020371938a3 NODE NAME null IPA ffffffffFfFfffffff IP_ADDR 0 0 0 0 CLASS Class3 FC4 TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 TYPE Lport PID 0113E8 WWPN 2100002037193670 PORT NAME SEAGATE ST39103FC 0004 WWNN 2000002037193670 NODE NAME null IPA ffffffffFfFfffffff IP_ADDR 0 0 0 0 CLASS Class3 FC4 TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 parm_get_num Returns the total number of configurable parameters Example emlxadm gt parm_get_num Result Th
4. X X X X X X X X X X X X X X X X X gt lt X lt X X X X X X X X X X X X X X X X X X gt lt X X X X X gt lt X X X lt Sun branded adapter Special firmware installation considerations apply Refer to the HBAny ware User Manual for more information about updating firmware The FCA Utilities User Manual Page 3 gt G EMULEX Installing or Updating the 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 Before installing the Emulex emlxu utilities package you must completely install the Sun StorEdge SAN Foundation Software package all the recommended patches as described in the Sun StorEdge SAN Foundation Software Installation Guide and the Emulex Sun Fibre Channel adapter driver package SUNWenlxs If an earlier version of the emlxu utilities package is already installed on the system the emlxu_install script will first remove the old version before installing the new version To install the utilities kit using the emlxu_install script Log in as root or su to root 2 Copy the utilities kit from your 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 00x sparc tar 3 Change to the directory where you put the ki
5. oxffffffff oxffffffff oxffffffff yes Verbose mask for error messages to the messages file num iocbs 128 1024 10240 1024 no Number of outstanding IOCBs driver can queue to adapter no network on 0 1 T I no Enable IP processing The FCA Utilities User Manual Page 27 gt G EMULEX label acko min 0 current 0 max 1 default 0 dynamic no desc Enable ACKO support label topology min 0 current 0 max 6 default 0 dynamic no desc Select Fibre Channel topology label link speed min 0 current 0 max 4 default 0 dynamic no desc Select link speed label num nodes min 2 current 512 max 512 default 512 dynamic no desc Number of fibre channel nodes NPorts the driver will support label cr delay min 0 current 0 max 63 default 0 dynamic no desc A count of milliseconds after which an interrupt response is generated label cr count min 1 current 1 max 255 default 1 dynamic no desc A count of I O completions after which an interrupt response is generated label assign alpa min 0x0 current 0x0 max Oxef default 0x0 dynamic no desc Assigns a preferred ALPA to the port Only used in Loop topology label adisc support min 0 current 1 max 2 default 1 The FCA Utilities User Manual Page 28 gt G EMULEX dynamic yes desc Sets the Fibre Channel ADISC login support level label pm support 0 min current 1 max 1 default 1
6. lt number gt i interval Returns all or part the last lt number gt of lines of the current driver message log and can update the screen every lt interval gt seconds if desired To stop the program from updating the screen press lt Ctrl gt lt C gt If no interval is provided the current message log is displayed with no additional updates and the emlxadm prompt returns Example emlxadm gt msgbuf 10 155130 01 1002033 B 1C35 emlxs0O DEBUG 800 ELS sent GA_NXT did fffffc 00011000 00000000 155130 02 1002034 4 00C9 emlxs0 DEBUG 801 ELS comp GA_NXT CT_ACC Rsn 0 Exp 0 020113e1 21000020 155130 02 1002035 B 1C35 emlxs0O DEBUG 800 ELS sent GA_NXT did fffffc 000113e1 00000000 155130 02 1002036 4 00C9 emlxs0 DEBUG 801 ELS comp GA NXT CT_ACC Rsn 0 Exp 0 020113e2 21000020 155130 02 1002037 B 1C35 emlxs0 DEBUG 800 ELS sent GA_NXT did fffffc 000113e2 00000000 155130 02 1002038 4 00C9 emlxs0 DEBUG 801 ELS comp GA NXT CT_ACC Rsn 0 Exp 0 020113e4 21000020 155130 03 1002039 B 1C35 emlxs0O DEBUG 800 ELS sent GA_NXT did fffffc 000113e4 00000000 155130 03 1002040 4 00C9 emlxs0 DEBUG 801 ELS comp GA NXT CT_ACC Rsn 0 Exp 0 020113e8 21000020 155130 03 1002041 B 1C35 emlxs0O DEBUG 800 ELS sent GA_NXT did fffffc 000113e8 00000000 155130 03 1002042 4 00C9 emlxs0 DEBUG 801 ELS comp
7. Run the emlxdrv utility program in interactive mode by typing the name of the program without any command line arguments emlxdrv After it is started the emlxdrv program scans the host system and prepares a driver configuration table consisting of bindings associations between the emlxs and LPFC drivers and a list of Emulex Fibre Channel adapter models After the table is prepared the utility returns the following EMLXDRV Driver Management Utility Version v1 00m COPYRIGHT 2004 2008 Emulex All rights reserved Driver Alias Present Boot Sun Models lpfs no no no LP8000S and LP9002S SBUS 800 no no no LP8000 and LP8000DC lpfc 900 yes no no LP9002 LP9002C LP9002DC and LP9402DC lpfc 980 no no no LP9802 and LP9802DC emlxs fa00 yes no no LP10000 LP10000DC and LP10000ExDC emlxs d00 no no no LP11000 and LP11002 emlxs fe00 no no no LPe1l1000 LPe11002 and LPe11004 emlxs 100 no no no LPel2000 and LPe12002 emlxs fe05 no no no LP21000 and LP21002 emlxs f 0a5 no no no 2G Blade Adapter emlxs only emlxs fc00 yes no yes LP10000 S and LP10000DC S emlxs only emlxs fc10 no no yes LP11000 S and LP11002 S emlxs only emlxs fc20 no no yes LPel1000 S and LPe11002 S emlxs only emlxs f c40 no no yes LPel2000 S and LPe12002 S emlxs only The FCA Utilities User Manual Page 31 Available commands set_emlxs lt Alias gt Sets emlxs driver to bind to the specified device s set_emlxs_sun Sets emlxs
8. This section provides a list of commands and descriptions that can be issued with the emlxadm utility Table 2 Alphabetical Listing of All Commands lt cmd_code hex gt command code on the adapter port This command provides support for the Emulex specific tests shown below or generic support to issue an adapter specific diagnostic code in hexadecimal to any third party adapter Peer For an Command Description example see boot_code enable or disable Sets or shows the boot code state of the current page 14 adapter dev_login lt wwpn gt Performs an FC login to an FC device on the page 14 network if not already logged in dev_logout lt wwpn gt Performs an FC logout to an FC device on the page 14 network if not already logged out dev_remove lt wwpn gt Removes the specified FC device from Leadville page 14 management Warning This command is currently not properly supported in the Leadville stack and will cause the host operating system to panic diag lt test parameters gt or diag code Performs the specified diagnostics function or page 15 The FCA Utilities User Manual Page 11 gt G EMULEX Table 2 Alphabetical Listing of All Commands Continued Command Description Foran example see download_boot lt filename gt Downloads the specified boot image file to the page 15 adapter download_fcode lt filename gt Down
9. a specified parameter in the driver msgbuf all lt number gt i interval Returns the driver s internal message log get_host_attrs Returns the host adapter and port attributes get_port_attrs lt index gt lt wwn gt all Returns the port attributes get_path lt index gt Returns the adapter path get_vpd Returns the adapter s Vital Product Data VPD boot code enable disable Sets or shows the boot code state in this HBA get_rnid wwpn Gets the RNID information for local or specified port get_inst Gets the driver instance q Exits this program h Returns this help screen hba Select another hba p Repeat previous command emlxadm gt Allows you to select another adapter to interface with This prevents you from having to exit and reenter the program Example Available Emulex HBA s 1 SFS emlxs0O devices pci 7c0 pci 0 pci 1 pci 0 2 SUNW emlxs 1 fp 0 0 CON NECTED 2 FCT emlxsl1 devices pci 7c0 pci 0 pci l1 pci 0 2 SUNW emlxs 1 1 CONNECTED Enter an HBA number or zero to exit link_status lt d_id gt Requests and returns the current link error status from the FC device specified by the d_id address Example emlxadm gt link status e8 D_ID e8 Link failures 3 Loss of sync count 1 Loss of signal count 0 Primitive sequence errors 0 0x0 Invalid tx words 1 Invalid CRC count 0 The FCA Utilities User Manual Page 24 EMULEX msgbuf all or
10. core dump buffer Example emlxadm gt get _dump_size Size 2033060 0x1f05a4 bytes get_fcode_rev Returns the current FCode revision of the adapter Example emlxadm gt get _fcode_rev FCODE revision LP10000 S 1 41a3 get_fw_rev Returns the current firmware revision of the adapter Example emlxadm gt get_fw_rev Firmware revision LP10000DC S 1 90a3 get_host_atirs Returns all of the current host adapter API attributes Example emlxadm gt get_host_attrs Hoxc FD st Attributes gt G EMULEX The FCA Utilities User Manual Manufacturer Sun Microsystems Inc Serial Number BG43918495 Model LP10000DC S Model Description EMULEX LIGHTPULSE LP10000DC S 2GB PCI X FIBRE CHANNEL ADAPTER Node WWN 20000000C942097E Node Symbolic Name none Hardware Version 1001206d Driver Version 1 11 t3 2006 04 25 11 43 Optional ROM Version 1 50a9testl Firmware Version 1 91b5 Vendor Specific ID co00 Number of HBA ports 1 Driver Name Emulex S s9 64 sparc v1 11f t3 Last Change 5 fp Instance e Node WWN 20000000C942097E Port WWN 10000000C942097E Port Fc Id 011700 Port Type Nport Port State Online Port Supported COS Class3 Page 18 gt G EMULEX Port Supported FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Active FC4 Types 00000120 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Symbolic Name
11. gt G EMULEX FCA Utilities Version 1 03h User Manual for the Emulex Sun LightPulse Fibre Channel Adapter Driver emlxs One Network One Company P003594 01A Rev A Connect with Emulex gt G EMULEX Copyright 2003 2009 Emulex All rights reserved worldwide No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of Emulex Information furnished by Emulex is believed to be accurate and reliable However no responsibility is assumed by Emulex for its use or for any infringements of patents or other rights of third parties which may result from its use No license is granted by implication or otherwise under any patent copyright or related rights of Emulex Emulex the Emulex logo AutoPilot Installer AutoPilot Manager BlockGuard Connectivity Continuum Convergenomics Emulex Connect Emulex Secure EZPilot FibreSpy HBAnyware InSpeed LightPulse MultiPulse OneCommand OneConnect One Network One Company SBOD SLI and VEngine are trademarks of Emulex All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations Emulex provides this manual as is without any warranty of any kind either expressed or implied including but not limited to the implied warranties of merchantability or fitness for a particular purpose Emulex may make improvements and changes to the product
12. lt d_id gt Requests and returns the current link error status from the FC device specified by the D_ID address page 24 msgbuf all or lt number gt i interval Returns all or part the last lt number gt of lines of the current driver message log and can update the screen every lt interval gt seconds if desired To stop the program from updating the screen press lt Cirl gt lt C gt If no interval is provided the current message log is displayed with no additional updates and the emlxadm prompt returns page 25 ns Performs and returns a complete query of the fabric name server page 25 p Repeats the last command page 29 parm_get lt label gt Gets the value of a specified parameter in the driver page 29 parm_get_list Returns a list of configurable parameters page 26 parm_get_num The FCA Utilities User Manual Returns the total number of configurable parameters page 26 Page 13 gt G EMULEX Table 2 Alphabetical Listing of All Commands Continued ea For an Command Description example see parm_set lt label gt lt value gt Sets the value of a specified parameter in the page 29 driver Only dynamic parameters can be set q Exits the utility program page 29 reset_hard Forces the adapter to perform a hardware reset page 29 reset_link lt wwpn or zero for local link gt Resets the local link if zero is specifie
13. on the adapter port This command provides support for the Emulex specific tests shown below or generic support to issue an adapter specific diagnostic code in hexadecimal to any third party adapter Tests emlx_biu pattern Performs the Bus Interface Unit test emlx_echo lt did gt pattern Performs the ECHO test to a specified port id emlx_post Performs the Power On Self Tests Parameters pattern 4 byte hex pattern to be used for test e g Example emlxadm gt diag emlx biu Result EMLX_DIAG_BIU Operation successful or emlxadm gt diag emlx_echo fffffc Result EMLX_ DIAG ECHO Operation successful or emlxadm gt diag emlx_post Result EMLX_DIAG_POST Operation successful Example emlxadm gt diag code 0x4526 Result CODE 0x4526 16 0x10 Note The return status from the adapter is displayed in decimal and hexadecimal if the diagnostic code is valid for the adapter No interpretation of the return status is provided download_boot lt filename gt Downloads the specified boot image file to the adapter Example emlxadm gt download boot TD190A4 PRG Image Components REL type size 143416 DWC file BOOT version 03845054 1 90a4 Current Boot 1 90a3 New Boot 1 90a4 143416 0x23038 bytes Are you sure you want to download this image y or n Downloading Done The FCA Utilities User Manual OxA5A5A5A5 Page 15 gt G EMULEX download_fcode lt filename gt
14. prompt is displayed you must enter one of the commands in the list The list is displayed automatically only once but you can display it again by typing lt h gt at the prompt To exit the program type lt q gt Some commands require additional arguments such as a FC World Wide Port Name WWPN or a FC port address D_ID To display the available arguments for a command enter the command without any arguments For example the command get_state requires a WWPN for the target device If only the command without the argument is entered the following statement appears to indicate that the command requires an argument to be executed For example emlxadm gt get_state Usage get_state lt wwpn gt emlxadm gt get_state 21000020371938fa State PORT DEVICE LOGGED IN The FCA Utilities User Manual Page 9 gt G EMULEX CLI Mode emixadm There are two ways to run emlxadm in a CLI mode 1 Device path option USAGE emlxadm lt device path gt y lt cmd gt cmd_options Run the emlxadm utility program using the device path option by typing the name of the program followed by the full device name of the desired adapter or a pattern string for multiple adapters followed by a valid command and any required command arguments In the following example the emlxadm utility pauses to ask if you want to continue before executing the command To specify a full device name type emlxadm devices pci le 600000 SUNW emlxs 2 fp 0 0 d
15. symbolic node name for a device dev_login lt wwpn gt Performs an FC login to a device dev_logout lt wwpn gt Performs an FC logout to a device get_state lt wwpn gt Returns current SFS state of a specified device dev_remove lt wwpn gt Removes the FC device from SFS management link status lt d_id gt Requests link error status from a specified D_ID get_fcode_ rev Returns the current Fcode revison of the HBA download_fcode filename Downloads the HBA fcode get_fw_rev Returns the current firmware revison of the HBA download_fw filename Downloads the HBA firmware get_boot_rev Returns the current boot revison of the HBA download_boot filename Downloads the HBA boot image get_dump_size Returns the HBA s firmware core dump size force dump Forces a firmware core dump on this HBA get_dump h Saves firmware core dump to a file get_topology Returns the current FC network topology reset link wwpn Resets the link of a specified FC device reset hard Resets the HBA diag Performs a diagnostic test on the HBA The FCA Utilities User Manual Page 23 hba gt G EMULEX ns Performs a complete query of the fabric name server parm get_num Returns the total number of configurable parameters parm_get_list Returns a list of configurable parameters parm get lt label gt Gets the value of a specified parameter in the driver parm_set lt label gt lt val gt Sets the value of
16. 000000 00000000 00000000 The FCA Utilities User Manual Page 21 gt G EMULEX Port Symbolic Name SEAGATE ST39103FC 0004 Port Supported Speed Unknown Port Speed Unknown Port Max Frame Size 0x0 bytes Fabric Name 0000000000000000 Port 3 Attributes Node WWN 2000002037193670 Port WWN 2100002037193670 Port Fc Id 0113e8 Port Type Unknown Port State Unknown Port Supported COS Class3 Port Supported FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Active FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Symbolic Name SEAGATE ST39103FC 0004 Port Supported Speed Unknown Port Speed Unknown Port Max Frame Size 0x0 bytes Fabric Name 0000000000000000 get_rnid wwpn Gets the RNID information for the local or specified port Example emlxadm gt get _rnid Offset 00 01 02 03 04 05 06 07 08 09 OA OB OC OD OF OF ASCII 0 31 30 30 30 30 30 30 30 63 39 34 63 62 64 34 65 10000000c94cbd4e 10 00 00 00 07 00 00 00 00 00 00 00 00 60 01 00 00 rppedia wee Sates 20 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 sescieceaeeevies 30 00 00 00 00 Done get_state lt wwpn gt Returns the current Leadville state of the specified FC device on the network Example emlxadm gt get_state 21000020371938fa State PORT DEVICE LOGGED _ IN get_sym_pname Returns the symbolic FC port name of the adapter port Example e
17. 020371938fa Done set_sym_nname lt string gt Sets the symbolic FC node name of the adapter to the string provided Note This operation is currently not supported by the Solaris Leadville stack Example emlxadm gt set_sym_nname Emulex Corporation ioctl FCIO SET SYM NNAME Operation not supported set_sym_pname lt string gt Sets the symbolic FC port name of the adapter to the string provided Note This operation is currently not supported by the Solaris Leadville stack Example emlxadm gt set_sym_pname Emulex Corporation ioctl FCIO SET SYM PNAME Operation not supported The FCA Utilities User Manual Page 30 gt G EMULEX Using the emIxdrv Utility The emlxdrv utility is used to bind associate 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 This utility is used for migrating a server and its adapters from LPFC to emlxs or vice versa Note that the simultaneous use of both drivers is not supported in production and should only be used as a step when migrating complex configurations between drivers If the driver binding configuration is changed the host system must usually be rebooted in order for the new configuration to take effect Modes of Operation emlxdrv The emlxdrv utility program can be run in two modes Interactive e CLI Interactive Mode emlxdrv
18. Downloads the specified FCode image file to the adapter Example emlxadm gt download_fcode LP10000DC S fcode Image Components REL type size 33848 DWC file BOOT version 03841512 1 50a2 Current Fcode 1 50a1 New Fcode 1 50a2 33848 0x8438 bytes Are you sure you want to download this image y or n y Downloading Result Operation successful Done download_fw lt filename gt Downloads the specified firmware image file to the adapter Note The Emulex FCA driver does not allow firmware updates to SUN branded adapters Example emlxadm gt download_fw LP10000DC S fw Image Components NOP type AWC file KERN version ff801315 1 30a5 DWC file SLI2 version 07831914 1 90a4 DWC prog TEST version 00f51010 1 00a0 DWC prog STUB version 02881914 1 90a4 DWC prog SLI1 version 06831914 1 90a4 DWC prog SLI2 version 07831914 1 90a4 Current Firmware 1 90a3 New Firmware 1 90a4 366712 0x59878 bytes Are you sure you want to download this image y or n y Downloading Done force_dump Forces the adapter to perform a firmware core dump to the core dump buffer Example emlxadm gt force dump Done get_boot_rev Returns the current boot revision of the adapter Example emlxadm gt get_boot_rev Firmware revision LP10000DC S 1 90a3 The FCA Utilities User Manual Page 16 gt G EMULEX get_dev_list Returns a list of FC devices currently seen by this adapter po
19. Utilities User Manual Page 32 CLI Mode emIxdrv gt G EMULEX The emlxdrv utility program can be run in CLI mode by typing the name of the program followed by a valid command and any required command arguments For example you can update the a device binding by entering all the information on one line at the operating system prompt emlxdrv set _emlxs 980 Updating 980 and LP9402DC emlxs only emlxs only emlxs only Done Driver Alias Present Boot Sun Models z lpfs no no no LP8000S and LP9002S SBUS 800 no no no LP8000 and LP8000DC lpfc 900 yes no no LP9002 LP9002C LP90D02DC emlxs 980 no no no LP9802 and LP9802DC emlxs fa00 yes no no LP10000 LP10000DC and LP10000ExDC emlxs fd00 no no no LP11000 and LP11002 emlxs fe00 no no no LPe1l1000 LPe11002 and LPe11004 emlxs 100 no no no LPel2000 and LPe12002 emlxs fe05 no no no LP21000 and LP21002 emlxs f 0a5 no no no 2G Blade Adapter emlxs only emlxs fc00 yes no yes LP10000 S and LP10000DC S emlxs f c10 no no yes LP11000 S and LP11002 S emlxs c20 no no yes LPe11000 S and LPe11002 S emlxs f c40 no no yes LPe1l2000 S and LPe12002 S emlxs only This mode of operation enables you to use the emlxdrv utility as part of a script or another program capable of executing system level calls Command Descriptions emIxdrv This section provides a list of commands that can be issued with the emlxdrv utility program You can view the list of commands a
20. and Usages irean ii E E 34 The FCA Utilities User Manual Page iii gt G EMULEX Introduction This document provides the information needed to use the Emulex emixadm and elmxdrv utility programs For system administrators this document includes information about the installation and removal of these utilities At the very least system administrators should be familiar with Solaris and the Sun StorEdge SAN Foundation Software SFS and should have access to standard system documentation Anyone working with this product should have some familiarity with the nature and use of Fibre Channel FC New in this Release The following commands are new to the 1 03h version e Force_dump This command forces the adapter to perform a firmware core dump to the core dump buffer e Get dump This command saves the firmware core dump to a file e Get_dump_size This command returns the adapter s firmware core dump size Fibre Channel Overview Fibre Channel is a general purpose high throughput low latency interconnect It employs serial bit transmission over copper media short wave and long wave optical media Cable distances may range up to 30 meters for copper media and up to 10 kilometers for optical media Transmission speeds currently range up to 8 gigabits per second or roughly 800 megabytes per second FC transmission protocols provide high reliability with bit error rates less than 1 in 10712 Interconnects may be configured as p
21. apter aliases listed on the screen Note that each alias is shared by multiple adapter models Driver bindings can be made only with an adapter alias and not with a specific adapter model You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt set_emlxs 980 Updating 980 Cannot unload module lpfc Will be unloaded upon reboot Done set_emlxs_all Sets the emlxs driver to bind to all devices You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt set_emlxs all Updating lpfs Updating 800 Updating 900 Cannot unload module lpfc Will be unloaded upon reboot Updating 980 Cannot unload module lpfc Will be unloaded upon reboot Updating fa0o0 Updating f d00 Updating fe00 Updating fc00 Updating fc10 Updating fc20 Done The FCA Utilities User Manual Page 37 gt G EMULEX set_emlxs_sun Sets the emlxs driver to bind to all Sun devices Example emlxdrv gt set_emlxs_ sun Updating fc00 Updating fcl0 Updating fc20 Done set_Ipfc lt alias gt Sets the Ipfc driver to bind to the specified devices You must specify one of the valid adapter aliases list
22. d or the page 30 link of a specified FC device on the network set_sym_nname lt string gt Sets the symbolic FC node name of the adapter page 30 to the string provided Note This operation is currently not supported by the Solaris Leadville stack set_sym_pname lt string gt Sets the symbolic FC port name of the adapter to page 30 the string provided Note This operation is currently not supported by the Solaris Leadville stack Command Usage boot_code enable or disable Sets or shows the boot code state of the current adapter Example emlxadm gt boot code Boot code Disabled emlxadm gt boot _code enable Boot code Enabled emlxadm gt boot _code disable Boot code Disabled dev_login lt wwpn gt Performs an FC login to an FC device on the network if not already logged in Example emlxadm gt dev_login 21000020371938fa Done dev_logout lt wwpn gt Performs an FC logout to an FC device on the network if not already logged out Example emlxadm gt dev_logout 21000020371938fa Done dev_remove lt wwpn gt The FCA Utilities User Manual Page 14 gt G EMULEX Removes the specified FC device from Leadville management WARNING This command is currently not properly supported in the Leadville stack and will cause the host operating system to panic diag lt test parameters gt or diag code lt cmd_code hex gt Performs the specified diagnostics function or command code
23. described in this manual at any time and without any notice Emulex assumes no responsibility for its use nor for any infringements of patents or other rights of third parties that may result Periodic changes are made to information contained herein although these changes will be incorporated into new editions of this manual Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 OpenSolaris DH CHAP Notice Contains portions of Covered Software subject to the Common Development and Distribution License CDDL Version 1 0 Such portions of Covered Software in Source Code form may be obtained from the web site www opensolaris org or by contacting online support from the web site www emulex com Derived from the RSA Data Security Inc MD5 Message Digest Algorithm Copyright C 1991 2 RSA Data Security Inc Created 1991 All rights reserved The FCA Utilities User Manual Page ii gige ei eia i E E E E A a A 1 New in this ReleaSe eeseeeeeseeseeeeettrsttttttttttiittiiirititiitititrittittttttrtttttteen 1 Fibre Channel Overvie W ccccceccceeee cece ee eeeecaaeee eee eeeeeeaaaaeeeeeeeetegeaaaeeeeeeeeeaaaes 1 The Solaris Fibre Channel Stack 0 ccccceeceeeeeeeeeeecneeeeeeeeeeeeeeccaeeeeeeeeeeeeenaaees 1 Installing the UtilitieS 00 ll ll ll ll ll ll ll ln Gn aaa 3 CS OMIM AUU ONIN 25s se cee cann a vacteeastaes caves E A R 3 Installing or Updating the Utilities Using
24. driver to bind to all Sun devices set_emlxs all Sets emlxs driver to bind to all devices set _lpfc lt Alias gt Sets lpfc driver to bind to the specified device s set_lpfc_nonsun Sets lpfc driver to bind to all non Sun devices clear dev lt Alias gt Clears driver binding to the specified device s clear _lpfc Clears all lpfc driver bindings clear _emlxs Clears all emlxs driver bindings clear sun Clears driver bindings to all Sun devices clear nonsun Clears driver bindings to all non Sun devices clear all Clears driver bindings to all devices q Exits this program emlxdrv gt The display comprises three parts the current driver configuration table a list of available commands and the emlxdrv prompt The driver configuration table contains the following columns of data Driver Indicates which driver emlxs Ipfc or if none is currently configured to bind or attach to a specific adapter alias Alias Indicates the specific adapter alias associated with a set of Emulex adapter models Driver bindings can be made only with a specific adapter alias and not with a specific adapter model Present Indicates whether this specific type of adapter is currently present in the host system Emlxdrv allows you to bind a driver to adapters that are not currently present in the system but that may be present at some point in the future Boot Indicates whether this specific type of adapter is currently providing connectiv
25. dynamic no desc Enables power management support parm_set lt label gt lt value gt Sets the value of a specified parameter in the driver Only dynamic parameters can be set Example This example sets a dynamic parameter emlxadm gt parm_set adisc support 2 label adisc support min 0 current 2 max 2 default 1 dynamic yes desc Sets the Fibre Channel ADISC login support level Note To make this change permanent you must edit the kernel drv emlxs conf file Example This example attempts to set a static parameter emlxadm gt parm_set network on 1 emlxadm EMLX PARM SET Parameter network on is not dynamic and cannot be changed here To make this change you must edit the kernel drv emlxs conf or the kernel drv emlx conf file s and reboot the system p Repeats the last command Example emlxadm gt get_num_devs There are 4 devices reported on this port emlxadm gt p emlxadm gt get_num_devs There are 4 devices reported on this port q Exits the utility program Example emlxadm gt q Exiting reset_hard Forces the adapter to perform a hardware reset Example emlxadm gt reset_hard Done The FCA Utilities User Manual Page 29 gt G EMULEX reset_link lt wwpn or zero for local link gt Resets the local link if zero is specified or the link of a specified FC device on the network Example emlxadm gt reset_link 0 Done or emlxadm gt reset_link 21000
26. ed on the screen Each alias is shared by multiple adapter models Driver bindings can be made only with an adapter alias and not with a specific adapter model You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt set_lpfc fa0o0 Updating fa00 Cannot unload module emlxs Will be unloaded upon reboot Done set_Ipfc_nonsun Sets the Ipfc driver to bind to all non Sun devices You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt set_lpfc_nonsun Updating lpfs Updating 800 Updating 900 Updating 980 Updating fa00 Cannot unload module emlxs Will be unloaded upon reboot Updating f d00 Updating fe00 Done The FCA Utilities User Manual Page 38
27. emlxu_install complete gt lt Execute emlxu_remove when ready to uninstall gt The FCA Utilities User Manual Page 4 gt S EMULEX 14 The script leaves a copy of the emlxu_remove script in your working directory with the original utilities kit tar file You can remove this script or leave it in the directory if you may want to uninstall the emlxu utilities from your system in the future See Removing the Utilities Using the emlxu_remove Script on page 5 for more details The emlxu utilities installation is complete The utility package s programs are located in the opt EMLXemlxu bin directory You do not need to reboot your system to run a utility program However to run a program you must either enter the program s full path name or add the package s bin directory opt EMLXemlxu bin to your environment s search path To use the man pages provided by the package you must also add the package s man directory opt EMLXemlxu man to your environment s man path For further information on installing and removing packages consult the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manual pages Removing 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 Removi
28. emoval of lt EMLXemlxu gt was successful 7 The script performs some cleanup and shows the following message lt Removing emlxu scripts gt lt emlxu_remove complete gt The FCA Utilities User Manual Page 5 gt G EMULEX The utilities package has been 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 Utilities Using the emlxu_install Script on page 4 e Installing the Utilities Package Manually on page 6 For additional information on installing and removing packages see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manual pages Installing the Utilities Package Manually 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 Removing the Utilities Package Manually on page 7 then return to this section to install the new utilities package Caution Before installing the Emulex utilities package you must first install the Sun StorEdge SAN Foundation Software package and all the recommended patches as described in the Sun StorEdge SAN Foundation Software Installation Guide provided by Sun To install the emlxu utilities package manually Log in as root or su to root 2 Copy the utilities kit from your distribution medium into a director
29. er of Discovered Ports Port 0 Attributes 4 Node WWN 20000020371938FA Port WWN 21000020371938FA Port Fc Id 0113e1 Port Type Unknown Port State Unknown Port Supported COS Class3 Port Supported FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Active FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Symbolic Name SEAGATE ST39103FC 0004 Port Supported Speed Unknown Port Speed Unknown Port Max Frame Size 0x0 bytes Fabric Name 0000000000000000 Port 1 Attributes Node WWN 2000002037193 8A2 Port WWN 21000020371938A2 Port Fc Id 0113 e2 Port Type Unknown Port State Unknown Port Supported COS Class3 Port Supported FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Active FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Symbolic Name SEAGATE ST39103FC 0004 Port Supported Speed Unknown Port Speed Unknown Port Max Frame Size 0x0 bytes Fabric Name 0000000000000000 Port 2 Attributes Node WWN 2000002037193 9A3 Port WWN 2100002037193 9A3 Port Fc Id 0113e4 Port Type Unknown Port State Unknown Port Supported COS Class3 Port Supported FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Active FC4 Types 00000000 00000000 00000000 00000000 00000000 00
30. ere are 18 configurable parameters in the driver parm_get lt label gt Gets the value of a specified parameter in the driver Example emlxadm gt parm_get adisc support label adisc support min 0 current 1 max 2 default 1 dynamic yes desc Sets the Fibre Channel ADISC login support level parm_get_list Returns a list of configurable parameters Example emlxadm gt parm_get_ list Parameter label console notices min 0x0 current 0x0 max Oxffffffff default 0x0 dynamic yes desc Verbose mask for notice messages to the console The FCA Utilities User Manual Page 26 label min current max default dynamic desc current max default dynamic desc current max default dynamic desc current max default dynamic desc current max default dynamic desc current max default dynamic desc current max default dynamic desc current max default dynamic desc gt G EMULEX console warnings 0x0 0x0 oxffffffff 0x0 yes Verbose mask for warning messages to the console console errors 0x0 0x0 oxffffffff 0x0 yes Verbose mask for error messages to the console log notices 0x0 oxffffffff oxffffffff oxffffffff yes Verbose mask for notice messages to the messages file log warnings 0x0 oxffffffff oxffffffff oxffffffff yes Verbose mask for warning messages to the messages file log errors 0x0
31. evctl get_state 21000020371938fa Information similar to the following is displayed Found path to 1 HBA port s HBA port devices pci le 6000000 SUNW emlxs 2 fp 0 0 devct1l gt Do you wish to continue with this device y n q y lt Response required State PORT DEVICE LOGGED IN If you do not want the utility to pause for verification add a y option just after the device path and the emlxadm utility will skip the verification For example emlxadm devices pci le 600000 SUNW emlxs 2 fp 0 0 devctl y get_state 21000020371938fa Information similar to the following is displayed Found path to 1 HBA port s HBA port devices pci le 600000 SUNW emlxs 2 fp 0 0 devetl State PORT DEVICE LOGGED IN If you want to run a command on multiple adapters at once you can use a pattern string instead of a full device path If the entire pattern string matches any part of an adapter device path the command will execute against that adapter Again in this example the emlxadm utility pauses to ask if you want to continue before executing the command For example emlxadm SUNW emlxs 2 get _num_devs Information similar to the following is displayed Found path to 2 HBA port s HBA port devices pci le 600000 SUNW emlxs 2 fp 0 0 devetl gt Do you wish to continue with this device y n q y lt Response required There are 5 devices reported on this port HBA port devices pci le 600000 SUNW emlxs 2 1 f
32. he current adapter API port attributes page 20 All of the port attributes can be displayed or a single port can be specified by lt index gt or lt wwn gt The total number of ports available can be seen in the Number of Discovered Ports attribute displayed using the get_host_attrs command The lt index gt argument is an index into this list The FCA Utilities User Manual Page 12 gt G EMULEX Table 2 Alphabetical Listing of All Commands Continued Command Description For an example see get_rnid wwpn get_state lt wwpn gt Gets the RNID information for the local or specified port Returns the current Leadville state of the specified FC device on the network page 22 page 22 get_sym_nname Returns the symbolic FC node name of the adapter port Note This operation is currently not supported by the Solaris Leadville stack page 22 get_sym_pname get_topology Returns the symbolic FC port name of the adapter port Note This operation is currently not supported by the Solaris Leadville stack Returns the FC network topology of the adapter port page 22 page 23 get_vpd Returns the current adapter s vital product data VPD page 23 Returns a help menu of utility commands page 23 hba Allows you to select another adapter to interface with This prevents you from having to exit and reenter the program page 24 link_status
33. hese modules consist of several tightly coupled pieces including a per port driver FP and a system wide transport layer FCTL driver The FP driver handles all per port state and common services needed by a variety of protocols and the FCA drivers The FCTL module provides consistent system wide access of Fibre Channel devices and services to upper layer protocols ULP and administration utilities The point of providing a Fibre Channel port transport interface is to abstract and define all services available through an FCA The FCA Utilities User Manual Page 1 gt G EMULEX driver needed by FC 4 ULP drivers such as the SCSI driver FCP and the IP driver FCIP The FCP function provides access to Fibre Channel disk and tape drives The IP function provides peer to peer networking such as TCP or UDP between Fibre Channel hosts Figure 1 shows the software stack for network operations and SCSI operations from the standpoint of a Solaris host FC Transport Layer FCTL Driver FC Port FP Driver a k a Leadville i r TCP IP Module Solaris Common i baza SPARC storage SCSI i SCSI driver ssd Architecture Stack DLP Module SCSA i FCIP ULP Driver FCP ULP Driver Solaris Common Fibre Channel Architecture Emulex LightPulse FCA a emixs Driver Emulex LightPulse Host Bus Adapter HBA Fibre Channel Network Figure 1 The Solaris Software Stack The FCA Utilities User Manual Page 2
34. intended to be a direct user interface to the Fibre Channel input output FCIO interface provided by the Sun StorEdge SFS The FCIO interface provides a Sun common ioctl interface to the FCTL driver which manages the FCA drivers for each Fibre Channel adapter attached to the host system Modes of Operation emlxadm The emlxadm utility program can be run in two modes e Interactive Command line interface CLI Interactive Mode emlxadm The emlxadm utility program can be run in an interactive command mode by typing the name of the program without any command line arguments For example emlxadm After it is started the emlxadm program scans the host system and prepares a list of qualified adapter ports to choose from Qualified adapter ports are devices that attach to the Sun StorEdge SFS through the FP driver After the list is prepared the utility shows the following information EMLXADM Device Management Utility Version v1 03h COPYRIGHT c 2004 2009 Emulex All rights reserved Available Emulex HBAs 1 SFS emlxs0O devices pci 7c0 pci 0 pci 1 pci 0 2 SUNW emlxs 1 fp 0 0 CONNECTED 2 FCT emlxs1 devices pci 7c0 pci 0 pci 1 pci 0 2 SUNW emlxs 1 1 CONNECTED Enter an HBA number or zero to exit Enter an adapter number or zero to exit You must choose from one of the available adapters in the list by entering the appropriate number In this example if you enter lt 1 gt the utility shows the adapter device na
35. ity to the system s boot disk This is important because emlxdrv does not allow you to change the driver binding to an adapter currently providing connectivity to the boot disk If the driver binding needs to be changed to a boot device the system must first be configured to boot through an adapter of another type This procedure is not in the scope of this document Sun Indicates whether this specific type of adapter is branded and sold directly by Sun Microsystems Models Provides a list of Emulex adapter models that are identified by a common adapter alias Driver bindings can be made only with a specific adapter alias and not with a specific adapter model After the driver configuration table is a list of available commands For a detailed explanation of each command and its arguments see Command Descriptions emlxdrv on page 33 Below the command list is an emlxdrv gt prompt From this point the utility is prompt driven When the prompt is displayed you must enter one of the commands in the list The current driver configuration table and the available command list are displayed automatically after each command is issued Some commands require an additional lt alias gt argument You must specify one of the valid adapter aliases listed in the current driver configuration table Each alias is shared by multiple adapter models Driver bindings can be made only with an adapter alias and not with a specific adapter model The FCA
36. lities Package Manually To remove the emlxu utilities package 1 Remove the EMLXemlxu utilities package by typing pkgrm EMLXemlxu 2 You are prompted to confirm the removal by the following message Do you want to remove this package y n q 3 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 4 Enter lt y gt The following message is displayed Removal of lt EMLXemlxu gt was successful For additional information on installing and removing packages see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manual pages Updating the Utilities Package Manually To update the emlxu utilities 1 Remove the old emlxu utilities package by following the instructions in Removing the Utilities Package Manually on page 7 2 Install the new emlxu utilities package by following the instructions in Installing the Utilities Package Manually on page 6 The FCA Utilities User Manual Page 7 gt G EMULEX Using 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 Sun branded devices HBAnyware provides the same functions as emlxadm and a number of additional ones on multiple systems through a choice of a graphical user interface and a scriptable command line interface It is
37. loads the specified FCode image file to the page 16 adapter download_fw lt filename gt Downloads the specified firmware image file to page 16 the adapter force_dump Forces the adapter to perform a firmware core page 16 dump to the core dump buffer get_boot_rev Returns the current boot revision of the adapter page 16 get_dev_list Returns a list of FC devices currently seen by page 17 this adapter port get_dump Saves the firmware core dump to a file page 17 get_dump_size Returns the adapter s firmware core dump size page 18 get_fcode_rev Returns the current FCode revision of the page 18 adapter get_fw_rev Returns the current firmware revision of the page 18 adapter get_host_atirs Returns all of the current host adapter API page 18 attributes get_host_params Returns the FC login parameters of this adapter page 19 port get_inst Returns the driver instance page 19 get_logi_params lt wwpn gt Returns the FC login common service page 19 parameters for a specified FC device on the network get_num_devs Returns the number of FC devices currently seen page 16 by this adapter port get_path lt index gt Returns the current Solaris device path for a page 20 specified adapter port The total number of ports available can be seen in the Number of HBA ports attribute displayed using the get_host_attrs command The lt index gt argument is an index into this list get_port_attrs lt index gt lt wwn gt or all Returns t
38. me selected and presents a list of command options HBA 1 devices pci 7c0 pci 0 pci l1 pci 0 2 SUNW emlxs 1 fp od 0 Available commands FCIO rev2 get_num_dev Returns the number of FC devices seen by this HBA get_dev_list Returns a list of FC devices seen by this HBA get_logi_params lt wwpn gt Returns the login parameters for a specified FC device get_host_ params Return the host parameters get_sym_pname Returns the symbolic port name of a device set_sym_pname lt string gt Sets the symbolic port name for a device get_sym_nname Returns the symbolic node name of a device set_sym_nname lt string gt Sets the symbolic node name for a device dev_login lt wwpn gt Performs an FC login to a device dev_logout lt wwpn gt Performs an FC logout to a device The FCA Utilities User Manual Page 8 gt E EMULEX get_state lt wwpn gt Returns current SFS state of a specified device dev_remove lt wwpn gt Removes the FC device from SFS management link_status lt d_id gt Requests link error status from a specified D_ID get_fcode_rev Returns the current Fcode revison of the HBA download_fcode filename Downloads the HBA fcode get_fw_rev Returns the current firmware revison of the HBA download_fw filename Downloads the HBA firmware get_boot_rev Returns the current boot revison of the HBA download_boot filename Downloads the HBA boot image get_dump_size Returns the HBA s fi
39. mlxadm gt get_sym_pname ioctl get_sym_nname FCIO GET SYM PNAME Operation not supported Returns the symbolic FC node name of the adapter port Example emlxadm gt get_sym_nname ioctl FCIO GET SYM NNAME Operation not supported The FCA Utilities User Manual Page 22 gt G EMULEX get_topology Returns the FC network topology of the adapter port Example emlxadm gt get_topology Topology PRIVATE_LOOP get_vpd Returns the current adapter s vital product data VPD Example emlxadm gt get_vpd Vital Product Data Identifier ID FC2G PCI X LP1O000DC SUN Part Number PN LP10000DC S Manufacturer MN Sun Microsystems Inc Serial Number SN BG43918495 Description V1 EMULEX LIGHTPULSE LP10000DC S 2GB PCI X FIBRE CHANNEL ADAPTER Model V Program Types V Port Number V 2 LP10000DC S 3 T2 83 88 T3 84 T6 83 T7 83 TB 83 TFF 80 4 0 h Returns a help menu of utility commands Example emlxadm gt h get_num_dev Returns the number of FC devices seen by this HBA get_dev_list Returns a list of FC devices seen by this HBA get _logi_params lt wwpn gt Returns the login paramters for a specified FC device get_host_params Return the host parameters get_sym_pname Returns the symbolic port name of a device set_sym_pname lt string gt Sets the symbolic port name for a device get_sym_nname Returns the symbolic node name of a device set sym _nname lt string gt Sets the
40. ng the Utilities Package Manually on page 7 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 Utilities Using the emlxu_install Script on page 4 for more details If you do not want to update the utilities package and only want to uninstall it use the emlxu_remove script by doing the following all emlxu files are removed 1 Log in as root or su to root 2 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 3 If you have the emlxu_remove script skip to step 4 If you do not have the emlxu_remove script but you do have the original emlxu utilities kit tar file extract the emlxu_remove script from the tar file by typing tar xf emlxu_kit 1 00x sparc tar emlxu_remove 4 Remove the emlxu utilities package by typing emlxu_remove 5 The script locates the EMLXemlkxu utilities package and the following message is displayed lt Removing EMLXemlxu package gt If no package is installed a message indicates this skip to step 7 Otherwise you are prompted to remove the package with the following message Do you want to remove this package y n q 6 Enter lt y gt The following message is displayed R
41. none Port Supported Speed 1Gb 2Gb Port Speed 1Gb Port Max Frame Size 0x800 bytes Fabric Name 0000000000000000 Number of Discovered Ports 4 Il get_host_params Returns the FC login parameters of this adapter port Example emlxadm gt get_host_params Host Dtype 0 FC4_type proto 0x00000120 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 State Online Linkspeed 1Gb D id 11700 LILP 5 Hard Addr 0 WWPN 10000000c942097e WWNN 20000000c942097e get_inst Returns driver instance for this adapter port Example emlxadm gt get_inst emlxs0 get_logi_params lt wwpn gt Returns the FC login common service parameters for a specified FC device on the network Example emlxadm gt get_logi_ params 21000020371938fa Login Parameters 00 00 00 00 20 20 00 00 88 00 08 00 00 00 02 00 00 01 4 21 00 00 20 37 19 38 fa 20 00 00 20 37 19 38 fa 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 The FCA Utilities User Manual Page 19 gt E EMULEX 00 00 00 00 00 00 00 00 00 00 00 00 80 00 00 00 00 00 08 00 00 00 00 00 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 get_num_devs Returns the number of FC devices currently seen by this adapter port Example emlxadm gt get_num_devs There are 4 devices reported on this port get_path lt index gt Returns the curren
42. oint to point loop or fabric network switch The FC specifications provide for the emulation of two traditional protocols SCSI and IP For storage FC provides an emulation of SCSI this emulation is dubbed FCP short for Fibre Channel Protocol a confusing acronym in that it refers specifically to SCSI on Fibre Channel rather than to the lower level protocols by which Fibre Channel itself operates Throughout this document we generally refer to FCP when we mention SCSI we are referring to the particular SCSI properties within FCP or to the original SCSI protocol For networking FC provides an encapsulation of IP Internet Protocol referred to in this document as IP The Solaris Fibre Channel Stack Each FC adapter is managed by an associated device driver A device driver acts as a translator between an operating system and the hardware so that the operating system s kernel need not know the specifics of the device it uses A device driver contains all of the code specific to operating a device and provides an input output I O interface to the rest of the system The Emulex Sun LightPulse adapter device driver for Solaris emlxs is a Fibre Channel adapter FCA driver as specified by the Sun Fibre Channel architecture also known as Leadville The heart of the Sun Fibre Channel architecture consists of the Fibre Channel transport layer FCTL modules which provide a common interface for various Fibre Channel adapters on a host T
43. oot Done clear_emlxs Clears all emlxs driver bindings You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt clear_emlxs Cannot unload module emlxs Will be unloaded upon reboot Updating fc00 Cannot unload module emlxs Will be unloaded upon reboot Updating fcl0 Cannot unload module emlxs Will be unloaded upon reboot Updating fc20 Cannot unload module emlxs Will be unloaded upon reboot Done clear_Ipfc Clears all LPFC driver bindings You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt clear _lpfc Updating 900 Cannot unload module Ilpfc Will be unloaded upon reboot Updating 980 Cannot unload module lpfc Will be unloaded upon reboot Done The FCA Utilities User Manual Page 35 gt G EMULEX clear_nonsun Clears driver bindings to all non Sun devices You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt clear _nonsun Updating lpfs Cannot unload module eml
44. p 0 0 devetl gt Do you wish to continue with this device y n q y lt Response required There are 0 devices reported on this port The FCA Utilities User Manual Page 10 gt S EMULEX If you do not want the utility to pause for verification add a y option just after the pattern string and the emlxadm utility will skip the verification For example emlxadm SUNW emlxs 2 y get _num_devs Information similar to the following is displayed Found path to 2 HBA port s HBA port devices pci le 600000 SUNW emlxs 2 fp 0 0 devetl There are 5 devices reported on this port HBA port devices pci le 600000 SUNW emlxs 2 1 fp 0 0 devetl There are 0 devices reported on this port 2 Instance option USAGE emlxadm i lt N SFS FCT or all gt y lt cmd gt cmd_option s Run the emlxadm utility program using the instance option by typing the name of the program followed by one of the options listed below followed by a valid command and any required command arguments lt N gt A specific emlxs driver instance N 1 means emlxsl N 2 means emlxs2 SFS All emlxs driver instances attached to the Sun SFS interface FCT All emlxs driver instances attached to the Sun COMSTAR interface all All emlxs driver instances This mode of operation enables you to use the emlxadm utility as part of a script or another program capable of executing system level calls Command Descriptions emlxadm
45. rmware core dump size force dump Forces a firmware core dump on this HBA get _dump h Saves firmware core dump to a file get topology Returns the current FC network topology reset _link wwpn Resets the link of a specified FC device reset _hard Resets the HBA diag Performs a diagnostic test on the HBA ns Performs a complete query of the fabric name server parm_get_ num Returns the total number of configurable parameters parm_get_ list Returns a list of configurable parameters parm_get lt label gt Gets the value of a specified parameter in the driver parm_set lt label gt lt val gt Sets the value of a specified parameter in the driver msgbuf all lt number gt i interval Returns the driver s internal message log get_host_attrs Returns the host adapter and port attributes get_port_attrs lt index gt lt wwn gt all Returns the port attributes get_path lt index gt Returns the adapter path get_vpd Returns the adapter s Vital Product Data VPD boot _code enable disable Sets or shows the boot code state in this HBA get_rnid wwpn Gets the RNID information for local or specified port get_inst Gets the driver instance q Exits this program h Returns this help screen hba Select another HBA p Repeat previous command emlxadm gt At the bottom of the command list is an emlxadm gt prompt From this point the utility is prompt driven When the
46. rt Example emlxadm gt get_dev_list Device 0 Dtype 0 FC4_type proto 0x00000100 0x00000000 0x00000000 0x00000000 0x00000000 Ox00000000 O0x00000000 O0x00000000 State Logged In D id 113e1 LILP 0 Hard Addr el WWPN 21000020371938fa WWNN 20000020371938fa Device 1 Dtype 0 FC4_type proto 0x00000100 0x00000000 0x00000000 0x00000000 0x00000000 Ox00000000 Ox00000000 Ox00000000 State Logged In Did 113e2 LILP 0 Hard Addr e2 WWPN 21000020371939a2 WWNN 20000020371939a2 Device 2 Dtype 0 FC4_type proto 0x00000100 0x00000000 0x00000000 0x00000000 0x00000000 Ox00000000 Ox00000000 O0x00000000 State Logged In Did 113e4 LILP 0 Hard Addr e4 WWPN 21000020371938a3 WWNN 20000020371938a3 Device 3 Dtype 0 FC4_type proto 0x00000100 0x00000000 0x00000000 0x00000000 0x00000000 Ox00000000 O0x00000000 O0x00000000 State Logged In D_ id 113e8 LILP 0 Hard Addr e8 WWPN 2100002037193670 WWNN 2000002037193670 get_dump lt get_dump or get_dump h gt Saves firmware core dump to a file The DMP and TXT files are created in the current working directory If h is specified then the only the header information of the firmware core is displayed The core files are not created Example emlxadm gt get_dump Core size 2033060 bytes files 2 TXT file 10348 DMP file 2022692 The FCA Utilities User Manual Page 17 get_dump_ size Returns the byte size of the adapter s firmware
47. t Solaris device path for a specified adapter port The total number of ports available can be seen in the Number of HBA ports attribute displayed using the get_host_attrs command The lt index gt argument is an index into this list Example emlxadm gt get _path 0 Adapter pci le 600000 SUNW emlxs 2 fp 0 0 emlxadm gt get _path 1 Adapter pci le 600000 SUNW emlxs 2 1 fp 0 0 get_port_attrs lt index gt lt wwn gt or all Returns the current HBA API port attributes All of the port attributes can be displayed or a single port can be specified by lt index gt or lt wwn gt The total number of ports available can be seen in the Number of Discovered Ports attribute displayed using the get_host_attrs command The lt index gt argument is an index into this list Example emlxadm gt get _port_attrs all Host Port Attributes Last Change 5 fp Instance e Node WWN 20000000C942097E Port WWN 10000000C942097E Port Fc Id 011700 Port Type Nport Port State Online Port Supported COS Class3 Port Supported FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 The FCA Utilities User Manual Page 20 Port Active FC4 Types EMULEX 00000120 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Symbolic Name none Port Supported Speed 1Gb 2Gb Port Speed 1Gb Port Max Frame Size 0x800 bytes Fabric Name 0000000000000000 Numb
48. t any time by running the emlxdrv utility in interactive mode see Interactive Mode emlxdrv on page 31 Table 3 Alphabetical Listing of All Commands Command Description See clear_all Clears driver bindings to all devices page 34 clear_dev lt alias gt Clears driver binding to the specified devices page 35 clear_emlxs Clears all emlxs driver bindings page 35 clear_lpfc Clears all Ipfc driver bindings page 35 clear_nonsun Clears driver bindings to all non Sun devices page 36 clear_sun Clears driver bindings to all Sun devices page 36 q Exits the program page 37 set_emlxs lt alias gt Sets the emlxs driver to bind to the specified devices page 37 set_emlxs_all Sets the emlxs driver to bind to all devices page 37 set_emlxs_sun Sets the emlxs driver to bind to all Sun devices page 38 The FCA Utilities User Manual Page 33 gt G EMULEX Table 3 Alphabetical Listing of All Commands Continued Command Description See set_lpfc lt alias gt Sets the Ipfc driver to bind to the specified devices page 38 set_lpfc_nonsun Sets the Ipfc driver to bind to all non Sun devices page 38 Command Usage clear_all Clears driver bindings to all devices You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot
49. t tar file by typing cd lt directory gt 4 Extract the emlxu_install script from the tar file by typing tar xf emlxu_kit 1 00x sparc tar emlxu_install 5 Install the kit by typing emlxu_install 6 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 9 The following text is displayed lt Removing old EMLXemlxu package gt 7 Ifan old package is installed you are prompted to remove it Do you want to remove this package y n q 8 Enter lt y gt The following message is displayed Removal of lt EMLXemlxu gt was successful 9 The script expands the utilities kit tar file and begins installing the new package The following message is displayed lt Expanding emlxu_kit 1 00x sparc tar gt lt Adding new package gt 10 The script installs the emlxu utilities package The package is prepared for installation and you are prompted for confirmation by the following message Do you want to continue with the installation of lt EMLXemlxu gt y n 11 Enter lt y gt The installation package provides running commentary on the installation process 12 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 13 The script performs some cleanup and shows the following messages lt Cleaning directory gt lt
50. the emlxu_install Script 0 000 0 000 4 Removing the Utilities Using the emlxu_remove Script ccccceeeeeeeeeeeeeees 5 Installing the Utilities Package Manually cee ceeeeeeeeeeeeeeeeeeeeeeteeeeetees 6 Removing the Utilities Package Manually 7 Updating the Utilities Package Manually eeecccccceeeeeeeeeeeeeeeeeeeeeeeeeteeeeeteees 7 Using thee mlx ad mit tty svn wsessnenenonsies EIEREN ERISEERIA IIET 8 Modes of Operation emlxadm ccceeeeeeteeeeeeeeeeeeeeeeeeeccaeeeeeeeeeeeeedaeeeeeetees 8 Interactive Mode CMIXAdM cceeeeeeeeeeeeeeeeeeeceeeaaaaaaaaaaaaaaaaaaaaaaaaaaaeeeeeeeees 8 CLI Mode MIXadM 0 2 cece ee eecceneeee eee ee eene eset eset eee etteccaaeeeeeeeetteeeaaeeeeeneee 10 Command Descriptions emlxadm cccceceeeeeceeeeeeeeeeeeeeeccaaeeeeeeeeetesseaeeeeeees 11 Command Usage cccccceeeeeeeccnneeeeeeeeeeeeeccaaeeeeeeeeeeececaeeeeeeeeseeeeccaeeeeeees 14 Using the emlxdrv Utility 20 cece cece eect cette eee e eee eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeegs 31 Modes of Operation GMIXCIV ccccceeeeeeeeeeeeeeccneeeeeeeeeeeeecaaeeeeeeeseeeeeteaeeeeeees 31 Interactive Mode CMIXIV ccccceceeeeeeeeeeeeeeeeeeeeeeeeeesaaaaaaaaaaaaaaaaaaaeeeeeees 31 CLI Mode MIXCrV 0 cccceceeeeeeeeceeee teers eeeeeeeeeeeeeeeeeteeeaaeeeeeeeeeteeenaeeeeeenee 33 Command Descriptions CMIXCIV cccceeeeeeeeecteeeeeeeeeeeeecceeeeeeeeeeteeeseeeeetees 33 Comm
51. xs Will be unloaded upon reboot Updating 800 Cannot unload module emlxs Will be unloaded upon reboot Updating 900 Cannot unload module lpfc Will be unloaded upon reboot Updating 980 Cannot unload module lpfc Will be unloaded upon reboot Updating fa0o Cannot unload module emlxs Will be unloaded upon reboot Updating f d00 Cannot unload module emlxs Will be unloaded upon reboot Updating fe0dod Cannot unload module emlxs Will be unloaded upon reboot Done clear_sun Clears driver bindings to all Sun devices You may see the message Cannot unload module This indicates that you must reboot the system to get a driver to unbind from that adapter alias emlxdrv only updates the system configuration for the next boot Example emlxdrv gt clear_sun Updating fc00 Cannot unload module emlxs Will be unloaded upon reboot Updating fcl10 Cannot unload module emlxs Will be unloaded upon reboot Updating fc20 Cannot unload module emlxs Will be unloaded upon reboot Done The FCA Utilities User Manual Page 36 gt G EMULEX q Exits the program If changes were made to the driver bindings a system reboot is usually required in order for all the changes to take effect Example emlxdrv gt q Exiting NOTE If changes were made then a system reboot may be required set_emIxs lt alias gt Sets the emlxs driver to bind to the specified devices You must specify one of the valid ad
52. y referred to here as lt directory gt The utilities kit is a tar file named something similar to emlxu_kit 1 00x sparc tar 3 Change to the directory where you put the kit tar file by typing cd lt directory gt 4 Extract the installation images from the tar file by typing tar xvf emlxu_kit 1 00x sparc tar 5 Install the EMLXemlxu utilities package by typing pkgadd d EMLXemlxu 6 The package is prepared for installation and you are prompted to confirm the installation with the following message Do you want to continue with the installation of lt EMLXemlxu gt y n Enter lt y gt The installation package provides running commentary on the installation process 8 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 EMLXemIxu bin directory You do not need to reboot your system to run a utility program However to run a program you must either enter the program s full path name or add the package s bin directory opt EMLXemIxu bin to your environment s search path To use the man pages provided by the package you must also add the package s man directory opt EMLXemlxu man to your environment s man path The FCA Utilities User Manual Page 6 gt G EMULEX Removing the Uti
Download Pdf Manuals
Related Search