Home

Solaris FCA Utilities Version 1.08.5.0 User Manual

1. EA 43 m M 44 Lans um 44 o EUR nds o inn r 44 MEINES TITLE I IL ILIUM 45 parm_set label value ccceccescc cece ccc eeeeeessssseeeeeeeeeeeeeeeseeessaaaeeeees 48 li A A AA etuawe tees tds 48 reset hald A 49 reset nk lt WWpn 0r 0S iii 49 set sym nname lt SEFING gt ec cece eee e cess eee e eee e eee eeeeeeeseseeeeeseeeeeseeessguaeeees 49 set sym pname lt SCFING gt cc ics cece eee e eee a stisni SEESE CSEE EVESEN EES EESE EEN 49 SOLANO Ai ii 50 4 Using the emixdrv Utility uineam euo eek une ho para NR Ap a ara ica ETE ES A Re Rasa raa 51 Interactive Mode of Operation for emlxdrv eeeeeeeeee eee ee eene enhn nnne 51 Displaying Bindings Between Drivers and Adapter Models 52 Entering emlxdry Command sisi io iba 54 gt PP ERE EE EEE EEE SE EAEE CEE E 54 CLI Mode of Operation for emlxdrV essssessssssccscsesesoseesosssesosseecoseecoosseseeo 54 Command Descriptions for emlxdrv ceeeeeeeeeeee eee eene e eee 56 ICOM a aeri e ESO o REDEEM MN EDI 56 clear driver all 25e rr AA 57 clear dey alias 59d o oos A esed A 58 clear driver emulex c iie erac torpet ra caa et atur a e Rape ra wa e a di OE Deae ir eei 58 clear driver oracle cinc ia ile 59 NAS 5
2. emlxadm get dump h Core size files TXT file DMP file 6580624 bytes 2 13728 6566876 Result if a valid dump does not exist in the driver memory Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 31 Command Descriptions for emlxadm emlxadm get dump h No core file available get dump size Returns the adapter s firmware core dump size Example Result if a valid dump exists in the driver memory emlxadm get dump size Size 6580624 0x646990 bytes Result if a valid dump does not exist in the driver memory emlxadm get dump size Size 0 0x0 bytes get fcode rev Returns the current FCode revision of the adapter Example emlxadm get fcode rev FCODE revision LP10000 S 1 41a3 get fw rev Returns the current firmware revision of the adapter Example emlxadm get fw rev Firmware revision LP10000DC S 1 90a3 get hba attrs Returns the current control attributes for the adapter Example emlxadm get hba attrs HBA Flash ROM Version SE HBA ATTR VER 0000 0001 Manufacturer Emulex Corporation Support Modes TOE NIC VM FCOE INI LRO O SEEPROM Version 2 32 IOCTL Version 0x00012345 EP Fw Version 0x00897654 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX NCSI Version Extended Timeout Model 3 Using the emlxadm Utility Command
3. disable devices pciQ0 0 pcil0de 5d8c pcil0df e602600 2 fpQ0 0 FCIO rev2 i interval Returns the number of FC devices seen by this HBA Returns a list of FC devices seen by this HBA Returns the login paramters for a specified FC device Return the host parameters Returns the symbolic port name of a device Sets the symbolic port name for a device Returns the symbolic node name of a device Sets the symbolic node name for a device Performs an FC login to a device Performs an FC logout to a device Returns current SFS state of a specified device Remove the FC device from SFS management Request link error status from a specified D ID Returns the current Fcode revison of the HBA Download the HBA fcode Returns the current firmware revison of the HBA Download the HBA firmware Returns the current boot revison of the HBA Returns the current PHY attributes for the HBA Download the HBA boot image Returns the HBA s firmware core dump size Force a firmware core dump on this HBA Saves firmware core dump to a file Returns the current FC network topology Resets the link of a specified public loop FC device Reset the HBA Perform a diagnostic test on the HBA Performs a complete query of the fabric name server Returns the total number of configurable parameters Returns a list of configurable parameters Gets the value of a specified parameter in the driver Sets the value of a specified pa
4. emlxs0 get linkinfo Returns the current link status information for the adapter port Example emlxadm get linkinfo Physical port 0 MAC Duplex Full Duplex MAC Speed 10 Gbps MAC Fault None Mgmt MAC Duplex None Mgmt MAC Speed None QOS Link Speed Disabled Logical Link Status Link Up get logi params wwpn Returns the FC login common service parameters for a specified FC device on the network Example emlxadm get logi params 21000020371938fa Login Parameters 00 00 00 00 20 20 00 00 88 00 08 00 00 f 00 02 00 00 01 f4 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 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A e 3 Using the emlxadm Utility 35 gt EMULEX Command Descriptions for emlxadm 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 80 00 00 00 00 00 08 00 00 ff 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 index Shows the current 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 page 32 The index argument is an index i
5. If the wwpn parameter is specified this command resets the link of the specified FC device on the network If the specified wwpn applies to a remote port the reset link wwpn only works if the remote port is on a public loop SFS uses the Loop Initialize ELS command to reset the link on a remote port The LINIT ELS command is valid only if the remote N Port is on a public loop If 0 zero is specified this command resets the local link Examples Resets the link of the specified FC device emlxadm reset link 21000020371938fa Done Resets the local link emlxadm reset link 0 Done set sym nname lt string gt Sets the symbolic FC node name of the adapter to the string provided Note This operation is not supported by the Solaris SFS stack Example emlxadm 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 not supported by the Solaris SFS stack Example emlxadm set sym pname Emulex Corporation ioctl FCIO SET SYM PNAME Operation not supported Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A Command Descriptions for emlxadm 2G EMULEX 3 Using the emlxadm Utility 50 set_throttle Temporarily sets the I O queue lt depth gt for a specified remote port s The lt depth gt is the maximum numb
6. emlxdrv gt set emlxs f980 Updating f980 Cannot unload module lpfc Will be unloaded upon reboot Done set driver name emulex Sets the specific driver name to bind to all Emulex branded devices The valid driver name values are emlxs elxfc Ipfc elxnic or oce Example emlxdrv set lpfc fa00 Updating fa00 Cannot unload module emlxs Will be unloaded upon reboot Done set driver name oracle Sets the specific driver name to bind to all Oracle branded devices The valid driver name values are emlxs elxfc Ipfc elxnic or oce Example emlxdrv gt set emlxs oracle Updating fc00 Updating fcl0 Updating fc20 Done Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A
7. msgbuf all number This command displays the current driver log with various 42 i interval options ns Performs and returns a complete query of the fabric name 43 server p Repeats the last command 44 parm get label Retrieves the value of a specified parameter in the driver 44 parm get list Returns a list of configurable parameters 45 parm get num Returns the total number of configurable parameters 44 parm set label value Sets the value of a specified parameter in the driver Only 48 dynamic parameters can be set q Exits quits the utility program 48 reset hard Forces the adapter to perform a hardware reset 49 reset link lt wwpn or 0 gt If the wwpn parameter is specified this command resets 49 the link of the specified FC device on the network If 0Q zero is specified this command resets the local link set sym nname lt string gt Sets the symbolic FC node name of the adapter to the string 49 provided Note This operation is not supported by the Solaris SFS stack set sym pname lt string gt Sets the symbolic FC port name of the adapter to the string 49 provided Note This operation is not supported by the Solaris SFS stack set throttle Temporarily sets the O queue depth for a specified remote 50 Solaris FCA Utilities Version 1 08 5 0 User Manual port P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 26 Command Descriptions for emlxadm boot
8. current 1024 max 10240 default 1024 dynamic no desc Number of outstanding IOCBs driver can queue to adapter label ub bufs min 40 current 1000 max 16320 default 1000 dynamic no desc Number of unsolicited buffers the driver should allocate label network on min 0 current 1 max 1 default 1 dynamic no desc Enable IP processing max 1 default 0 dynamic no desc Enable ACKO support label topology min 0 current 0 max 6 default O0 dynamic no desc Select Fibre Channel topology Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 47 gt EMULEX Command Descriptions for emlxadm 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 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 1 0 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 dynamic yes Solaris
9. get throttle WWPN Depth 21000011c6810947 512 21000011c681065f 512 21000011c68108c0 512 21000011c681061d 512 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A ne e 3 Using the emlxadm Utility 40 gt EMULEX Command Descriptions for emlxadm get_topology Returns the FC network topology of the adapter port Example emlxadm gt get topology Topology PRIVATE LOOP get vpd Displays the current adapter s vital product data Example emlxadm get vpd Vital Product Data Identifier ID FC2G PCI X LP10000DC Oracle Part Number P LP10000DC S Manufacturer M Oracle Serial Number S BG43918495 EMULEX LIGHTPULSE LP10000DC S 2GB PCI X FIBRE CHANNEL ADAPTER LP10000DC S T2 83 88 T3 84 T6 83 T7 83 TB 83 TFF 80 0 Model Program Types PN MN SN Description V1 V2 V3 Port Number V4 Returns the help screen of the available commands Example This example shows the help screen for an adapter port that is attached to an SFS or FCT stack emlxadm h Available commands FCIO rev2 get num devs 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 string Sets the symbolic port name for a device
10. 21000020371939a2 PORT NAME SEAGATE ST39103FC 0004 WWNN 20000020371939a2 NODE NAME null EPA fftffffftffffftftf IP ADDR 0 0 0 0 CLASS Class3 FC4 TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 TYPE Lport PID 0113E4 WWPN 21000020371938a3 PORT NAME SEAGATE ST39103FC 0004 WWNN 20000020371938a3 NODE NAME null IPA ffffffffffffffff IP ADDR 0 0 0 0 CLASS Class3 FC4 TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 44 Command Descriptions for emlxadm TYPE Lport PID 0113E8 WWPN 2100002037193670 PORT NAME SEAGATE ST39103FC 0004 WWNN 2000002037193670 NODE NAME null IPA ffffffffffffffff IP ADDR 0 0 0 0 CLASS Class3 FC4 TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Repeats the last command Example emlxadm get num devs There are 4 devices reported on this port emlxadm p emlxadm get num devs There are 4 devices reported on this port parm get num Returns the total number of configurable parameters Example emlxadm parm get num Result There are 18 configurable parameters in the driver parm get label Gets the value of a specified parameter in the driver Example emlxadm parm get adisc support label adisc support min O0 current 1 max 2
11. CUMP SIZE io ires ones ree yr Ra EAE PEN ER RREP RE RES ANE E E ENSE REFUSER ERR C EE Y EET KE 31 get PCOS NOV ri DI T UELUT 31 get PW TEV ii OS e ea 31 Set hba adi oic err err p a Er n aao EEEE REV TEE UE F RE EP REY KS 31 Set host AtS oe cede eere ee aa es AA AAA ad 32 set host paraffiS 1 eo teer IE ay S ERU ERE TENE EORR YR NEUEN sea UP IA ERR YO TATE Ee gr 33 DSC TEETH cus 34 get MIO UII EL 34 g t logi params WWDE solari ans 34 set NUM deVsi ii cieeee e err eerte NARA IRALA A 35 i i Ec E 35 get phy attis ceres s coeevi eu ae ERES IE Pega IE Ea UU nav NE EE S Ode ERE Cd UE Da Pet ud e PUN Vd 36 get port attrs index wwn all cc cccccc cece eee eeeeseeeeeeeeeeeeeeeeeessegaeees 36 get rmd WWI ici A A peux beu via e eda MEE 38 get State lt WWDN gt i iere cen pese codicia FERRE CES RA EI RE ERN EROR STORE E tae 39 get sym nname iueeeeeeee eee A 39 get Sym pnalme ieeeseeseeeexse A A Au uve ve ve PKs EY VE ER 39 get CHOLES 39 Set COPOS sia 40 get VO A A Auro 40 ETT 40 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2c EMULEX Table of Contents 5 lp IH 41 Unk status d AS ierit ve e Re ne Rer VE we err xv REESE a s eae 42 msebuf all number 1 interval ssi ar riada 42 OS
12. Descriptions for emlxadm 0 OneConnect OCe10100 Description Serial Number IP Version Firmware Version BIOS Version REDBOOT Version Driver Version Flash Firmware Version Functions Supported Max CDB Length ASIC Revision Generational GUID HBA Port Count Multifunction Device iSCSI Version Def Linkdown Timout Physical Port Max Domains Supported HBA Status Cache Valid HBA MTU Firmware Post Status iSCSI Features PCI Vendor ID PCI Device ID PCI SubVendor ID PCI SubDevice ID PCI Bus Number PCI Device Number PCI Function Number Interface Type Unique Identifier Net Filters get host attrs BladeEngine 2 10Gb FCoE Initiator 0x425439343138323738310000000000000000000000000000 IPv4 2 701 374 2 2 701 374 2 2 0 38 0 Le I OL 637 AZ A2 rue Operational True 8342 8342 000000 0xC000 LIST MODE 0 0x19a2 0x0700 0x10df 0xe602 0 0 0 0 0 8 Displays all of the current host adapter API attributes Example emlxadm gt get_host_attrs Host Attributes Manufacturer Serial Number Model Oracle Microsystems BG43918495 LP10000DC S Solaris FCA Utilities Version 1 08 5 0 User Manual Inc P009430 01A Rev A 32 2G EMULEX 3 Using the emlxadm Utility 33 Command Descriptions for emlxadm Model Description EMULEX LIGHTPULSE LP10000DC S 2GB PCI X FIBRE CHANNEL ADAPTER No
13. FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 48 Command Descriptions for emlxadm desc Sets the Fibre Channel ADISC login support level label pm support min 0 current 1 max 1 default 1 dynamic no desc Enables power management support parm set label value Sets the value of a specified parameter in the driver Only dynamic parameters can be set Note To make this change permanent you must edit the kernel drv emlxs conf file Examples This example sets a dynamic parameter emlxadm 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 This example attempts to set a static parameter which is not allowed emlxadm 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 ck the kernel drv emlx conf file s and reboot the system Exits quits the utility program Example emlxadm q Exiting Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 49 Command Descriptions for emlxadm reset hard Forces the adapter to perform a hardware reset Example emlxadm reset hard Done reset link wwpn or 0
14. additional ones on multiple systems through a choice of a graphical user interface and a scriptable command line interface Interactive Mode of Operation for emlxadm To run the emlxadm utility in interactive mode type emlxadm without any command line arguments For example emlxadm Displaying Available Emulex Adapters After the emlxadm utility is started it scans the host system and prepares a list of qualified adapter ports Qualified adapter ports are devices that are attached to the emlxs elxfc oce or elxnic driver After each list number the display indicates the adapter s type of stack and type of driver For example Available Emulex HBA s 1 SFS emlxs0 devices pci 0 0 pcildde 5d c pcilddf e602 0 2 fp 0 0 CONNECTED 2 NIC oce0 devices pci80 0 pcil0de 5dG8c pcil0df e60200 CONNECTED 3 SFS emlxsl devices pci80 0 pcil0de 5d8c pcil0df e60200 3 fpQ0 0 CONNECTED 4 NIC ocel devices pci 0 0 pcildde 5d c pcilddf e602 0 1 CONNECTED 5 FCT emlxs2 devices pci 0 0 pcildde 5d d pcilddf 100 0 CONNECTED 6 SFS emlxs3 devices pci 0 0 pcildde 5d d pcilddf f100 0 1 fp 0 0 CONNECTED Enter an HBA number or zero to exit In this example six adapter ports are available For each adapter the type of stack is indicated The three types are e SFS the Oracle SFS stack e FCT the Oracle COMSTAR stack e NIC the Oracle networking stack After the available adapter list is displayed you are prompte
15. clear oracle Updating fc00 Cannot unload module Will be unloaded upon Updating fc10 Cannot unload module Will be unloaded upon Updating fc20 Cannot unload module Will be unloaded upon Done Clears bindings to all Oracle branded devices for all drivers Clears bindings to all Oracle branded devices for FC drivers Clears bindings to all Oracle branded devices for NIC drivers acle Clears bindings to all Oracle branded devices for a specific driver emlxs reboot emlxs reboot emlxs reboot Exits quits the emlxdrv utility Note If changes were made to the driver bindings a system reboot is required for the changes to take effect If NIC changes were made a system reboot is also required Example emlxdrv q Exiting Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX NOTE If changes wer mad refresh 4 Using the emlxdrv Utility 60 Command Descriptions for emlxdrv then a system reboot may be required Refreshes the host bindings and main display with the latest information Example emlxdrv refresh The following output is displayed FC Driver Alias Pres Boot Oracle emlxs elxfc lpfc Models elxfc lpfs E yes yes yes LP8000S LP9002S SBUS elxfc 800 S S yes LP8000 LP8000DC elxfc 900 S S yes LP9002 LP9002C LP9002DC LP9
16. default 1 dynamic yes desc Sets the Fibre Channel ADISC login support level Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 45 Command Descriptions for emlxadm 2G EMULEX parm get list Returns a list of configurable parameters Example emlxadm 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 label console warnings min 0x0 current 0x0 max Oxffffffff default 0x0 dynamic yes desc Verbose mask for warning messages to the console label console errors min 0x0 current 0x0 max Oxffffffff default 0x0 dynamic yes desc Verbose mask for error messages to the console label log notices min 0x0 current Oxffffffff max Oxffffffff default Oxffffffff dynamic yes desc Verbose mask for notice messages to the messages fil label log warnings min 0x0 current Oxffffffff max Oxffffffff default Oxffffffff dynamic yes desc Verbose mask for warning messages to the messages fil Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 46 gt EMULEX Command Descriptions for emlxadm label log errors min 0x0 current Oxffffffff max Oxffffffff default Oxffffffff dynamic yes desc Verbose mask for error messages to the messages fil label num iocbs min 128
17. did fffffc 00011000 00000000 55130 02 1002034 4 00C9 eml1xs0 DEBUG 801 ELS comp GA NXT CT ACC Rsn 0 Exp 0 020113e1 21000020 55130 02 1002035 B 1C35 eml1xs0 DEBUG 800 ELS sent GA NXT did fffffc 000113e1 00000000 55130 02 1002036 4 00C9 eml1xs0 DEBUG 801 ELS comp GA NXT CT ACC Rsn 0 Exp 0 020113e2 21000020 55130 02 1002037 B 1C35 eml1xs0 DEBUG 800 ELS sent GA NXT did fffffc 000113e2 00000000 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 43 55130 55130 55130 55130 emlxadm ns Command Descriptions for emlxadm 02 1002038 4 00C9 emlxs0 DEBUG 801 ELS comp GA NXT CT ACC Rsn 0 Exp 0 020113e4 21000020 03 1002039 B 1C35 emlxs0 DEBUG 800 ELS sent GA NXT did fffffc 000113e4 00000000 03 1002040 4 00C9 emlxs0 DEBUG 801 ELS comp GA NXT CT ACC Rsn 0 Exp 0 020113e8 21000020 03 1002041 B 1C35 emlxs0 DEBUG 800 ELS sent GA NXT did fffffc 000113e8 00000000 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 ffffffffffffffff IP ADDR 0 0 0 0 CLASS Class3 FC4 TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 TYPE Lport PID 0113E2 WWPN
18. emlxs driver instances all emlxs driver instances a specific elxfc driver N 2 for elxfc2 or N 2 1 for elxfc2 1 all SFS elxfc driver instances all FCT elxfc driver instances all elxfc driver instances a specific oce driver N 2 for oce2 or N 5 for oce5 all oce driver instances a specific elxnic driver N 2 for elxnic2 or N 5 for elxnic5 all oce driver instances command will be executed on all device paths containing the specified device path string Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 23 gt EMULEX Command Descriptions for emlxadm y If multiple devices are found the utility will ask for verification before executing the command on each device This option will cause the utility to skip the verification and automatically execute the command on each device Command Descriptions for emlxadm This section provides a list of commands and descriptions that can be issued with the emlxadm utility Table 3 1 summarizes this command list including abbreviated descriptions Table 3 1 Summary for emlxadm Commands Command Syntax Description Page boot code enable Sets or shows the boot code state of the current adapter 26 disable dev login wwpn Performs an FC login to an FC device on the network if not 26 already logged in dev logout lt wwpn gt Performs an FC logout to an FC device on the network if 26
19. get sym nname Returns the symbolic node name of a device set sym nname string 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 get state lt wwpn gt Returns current SFS state of a specified device dev remove lt wwpn gt Remove the FC device from SFS management link status d id Request link error status from a specified D ID get fcode rev Returns the current Fcode revison of the HBA Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 44 Command Descriptions for emlxadm download fcode filename Download the HBA fcode get fw rev Returns the current firmware revison of the HBA download fw filename Download the HBA firmware get boot rev Returns the current boot revison of the HBA download boot filename Download the HBA boot image get dump size Returns the HBA s firmware core dump size force dump Force 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 public loop FC device reset hard Reset the HBA diag ax Perform 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 para
20. gt lt EMULEX Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A Emulex Connects Servers Storage and People 2G EMULEX Copyright O 2002 2013 Emulex All rights reserved worldwide No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of Emulex Information furnished by Emulex is believed to be accurate and reliable However no responsibility is assumed by Emulex for its use or for any infringements of patents or other rights of third parties which may result from its use No license is granted by implication or otherwise under any patent copyright or related rights of Emulex Emulex the Emulex logo AutoPilot Installer AutoPilot Manager BlockGuard Connectivity Continuum Convergenomics Emulex Connect Emulex Secure EZPilot FibreSpy HBAnyware InSpeed LightPulse MultiPulse OneCommand OneConnect One Network One Company SBOD SLI and VEngine are trademarks of Emulex AII 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 and without any notice Emulex as
21. its lt wwpn gt argument 21000020371938fa Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A e 3 Using the emlxadm Utility 20 gt EMULEX CLI Mode of Operation for emlxadm 4 emlxadm devices pci le 600000 SUNW emlxs 2 fp 0 0 devetl get state 21000020371938fa The elxadm utility returns some status but pauses for a response before running the command Found path to 1 HBA port s HBA port devices pci le 6000000 SUNW emlxs 2 fp 0 0 devetl gt Do you wish to continue with this device y n q y After the user types y the emlxadm utility runs the command State PORT DEVICE LOGGED IN Running a Command without User Verification Using y If you do not want the emlxadm utility to pause for verification before running the command include the y option after the full device name For example when the user types emlxadm the y option the full device name the command and its argument the elxadm utility runs command immediately emlxadm devices pci le 600000 SUNW emlxs 2 fp 0 0 devctl y get state 21000020371938fa 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 Device Path Option for Multiple Adapters When using the device path option for multiple adapters use a pattern string for the lt device path gt parameter If the pattern string matches any par
22. the original emlxu utilities package tar file You can use emlxu_remove script later when you want to remove the emlxu utilities from your system See Removing the Utilities for Solaris 10 on page 13 for more details You can also delete the emlxu_remove script The emlxu utilities installation is complete The emlxu utilities package s programs are located in the opt EMLXemlxu bin directory 9 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 manual man pages provided by the package you must also add the package s man directory opt EMLXemlxu man to the system environment s man path Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 2 Installing and Removing Utilities 11 Installing the Utilities for Solaris 11 For more information on installing and removing packages see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M man pages Installing the Utilities Manually Note Ifanearlier version of the EMLXemlxu utilities package is already installed and you want to install a newer version you must remove the earlier version manually as detailed in Removing the Utilities Manually on page 14 before installing the newer utilities package manually To install the utilities package ma
23. yes LP10000 S LP10000DC S yes yes S LP11000 S LP11002 8 yes yes LPe11000 S LPe11002 S yes yes LPe12000 S LPe12002 S E yes yes OCe10101 OCe10102 yes yes OCe11101 OCe11102 Pres Oracle oce elxnic Models yes yes OCe10101 OCe10102 yes yes OCel1101 OCel11102 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 4 Using the emlxdrv Utility Command Descriptions for emlxdrv Command Descriptions for emlxdrv Note Youcan view the list of commands at any time by running the emlxdrv utility in interactive mode see Interactive Mode of Operation for emlxdrv on page 51 This section provides a list of commands that can be issued with the emlxdrv utility program Table 4 3 summarizes this command list including abbreviated descriptions Table 4 3 Summary of emlxdrv Commands Command Description Page clear Clears the bindings from the specified driver s to the specified device s The 56 clear command has several options clear driver all clears bindings from the specified driver to all devices 57 e clear dev alias clears bindings from a valid adapter alias to its associated 58 devices e clear driver emulex clears bindings from the specified driver to all 58 Emulex branded devices clear driver oracle clears bindings from the specified driver to all 59 Oracle branded devices The valid
24. 00 Cannot unload module emlxs Will be unloaded upon reboot Done clear driver emulex Clears the bindings from the specified driver to all Emulex branded devices The valid driver values are fc nic and driver name as defined in the following section Command Options clear emulex Clears bindings from all drivers to all Emulex branded devices clear fc emulex Clears bindings from FC drivers to all Emulex branded devices clear nic emulex Clears bindings from all NIC drivers to all Emulex branded devices clear driver name emulex Clears bindings from a specific driver indicated by its name to all Emulex branded devices Example emlxdrv clear emulex Cannot unload module emlxs Will be unloaded upon reboot Updating fc00 Cannot unload module emlxs Will be unloaded upon reboot Updating fc10 Cannot unload module emlxs Will be unloaded upon reboot Updating fc20 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX Cannot unload module Will be unloaded upon Done clear driver oracle 4 Using the emlxdrv Utility 59 Command Descriptions for emlxdrv emlxs reboot Clears bindings from the specified driver to all Oracle branded devices The valid driver values are fc nic and driver name as defined in the following section Command Options clear oracle Clear fc oracle clear nic oracle clear driver name or Example emlxdrv gt
25. 402DC elxfc 980 S S yes P9802 LP9802DC elxfc fa00 S S yes LP10000 LP10000DC P10000ExDC elxfc fdO00 S S yes LP11000 LP11002 elxfc fe00 yes S S yes LPe11000 LPe11002 LPe11004 elxfc fel2 yes yes yes LPe11000 LPe11002 LPe11004 elxfc f100 yes yes yes LPe12000 LPe12002 elxfc FELLE yes yes yes LPe12000 LPe12002 elxfc f112 yes yes yes LPe12000 LPe12002 elxfc fe05 x yes yes yes LP21000 LP21002 elxfc f0a5 e yes yes 2G Blade Adapter emlxs fc00 yes yes LP10000 S LP10000DC S emlxs fclO0 yes yes yes LP11000 S LP11002 S emlxs fc20 yes yes LPe11000 S LPe11002 S emxls fc40 yes yes LPe12000 S LPe12002 S elxfc 704 yes yes OCe10101 0OCe10102 elxfc 714 yes yes yes OCe11101 OCe11102 NIC Driver Alias Pres Oracle oce elxnic Models oce 700 yes yes OCe10101 0OCe10102 elxnic 710 yes yes OCe11101 OCe11102 Available Commands Set Sets driver bindings to specified devices Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX clear refresh set 4 Using the emlxdrv Utility 6 1 Command Descriptions for emlxdrv Clears driver bindings to specified devices Refresh driver bindings to current devices Exits this program This command sets the bindings from the specified driver emlxs elxfc Ipfc elxnic or oce to the specified device s This comma
26. 9 a o o 60 AA 61 set driver name lucir rer rrr nr xr neon anno eu n ERR rote Fen E iaa bot 61 set driver name alias oerte ener try sda nr ntn nr enne rnnt nee 61 set driver name emulex eeeceeeeeeeeeeee eene hene ina hne nnn 62 set driver name oracle 5 eese eet ther rre een nnne E uno nae ann yn en En 62 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX List of Tables 6 List of Tables Table 3 1 Summary for embxadm Commands vixusonroconisian cnn e Rune cra ld EE EF Run 23 Table 4 1 FC Driver Configuration Table Heading Descriptions uLeesuueueu 53 Table 4 2 NIC Driver Configuration Table Heading Descriptions suueue 53 Table 4 3 Summary of emlxdry Commiands 5 22 ko ad ue En Ran E ERRWRI YER RaR WEAK ERERUEVR KE 56 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 1 Introduction 5 EMULEX Bou s 1 Introduction Overview This Solaris Fibre Channel Adapter FCA Utilities User Manual provides information for the Emulex emlxadm and emlxdrv utility programs e emlxadm changes driver parameters through a local interactive or command line interface CLI mode It can also update firmware on non Oracle branded devices e emlxdrv binds associates various Fibre Channel FC and network interface card NIC drivers to various FC and NIC adapter models respectively Audience For system adminis
27. NNECTED Enter an HBA number or zero to exit Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 42 gt EMULEX Command Descriptions for emlxadm 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 link status e8 D ID e8 Link failures 3 0x3 Loss of sync count 12 0xc Loss of signal count 0 0x0 Primitive sequence errors 0 0x0 Invalid tx words 17 0x11 Invalid CRC count 0 0x0 msgbuf all number i interval This command displays the current driver log with various options Parameters all If the all parameter is specified this command displays all of the current driver message log lt number gt If the lt number gt parameter is specified this command displays the last lt number gt of lines of the current driver message log i interval Using the i interval argument enables the screen to be refreshed every interval of seconds If the i interval argument is not provided the driver message log is displayed followed by the emlxadm gt prompt To stop the command from displaying the current driver log press lt Ctrl gt and lt C gt at the same time Example In this example the last ten lines of the current driver log is displayed emlxadm gt msgbuf 10 55130 01 1002033 B 1C35 Jemlxs0 DEBUG 800 ELS sent GA NXT
28. Speed 1Gb Port Max Frame Size 0x800 bytes Fabric Name 0000000000000000 Number of Discovered Ports 4 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX Port 0 Attributes Node WWN Port WWN Port Fc Id Port Type Port State Port Supported COS Port Supported FC4 Types Port Active FC4 Types Port Symbolic Name Port Supported Speed Port Speed Port Max Frame Size Fabric Name Port 1 Attributes Node WWN Port WWN Port Fc Id Port Type Port State Port Supported COS Port Supported FC4 Types Port Active FC4 Types Port Symbolic Name Port Supported Speed Port Speed Port Max Frame Size Fabric Name Port 2 Attributes Node WWN Port WWN Port Fc Id Port Type Port State Solaris FCA Utilities Version 1 08 5 0 User Manual 20000020371938FA 21000020371938FA 0113e1 Unknown Unknown Class3 00000000 00000000 00000000 00000000 SEAGATE ST39103FC Unknown Unknown 0x0 bytes 0000000000000000 20000020371938A2 21000020371938A2 0113e2 Unknown Unknown Class3 00000000 00000000 00000000 00000000 SEAGATE Unknown Unknown 0x0 bytes 0000000000000000 20000020371939A3 21000020371939A3 0113e4 Unknown Unknown 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 ST39103FC 3 Using the emlxadm Utility Command Descr
29. _code enable disable Shows or sets the boot code state of the current adapter Examples To show the current boot code emlxadm gt boot code Boot code Disabled To enable the boot code emlxadm boot code enable Boot code Enabled To disable the boot code emlxadm boot code disable Boot code Disabled dev login lt wwpn gt Performs an FC login to an FC device on the network if it is not already logged in Example emlxadm dev login 21000020371938fa Done dev logout wwpn Performs an FC logout to an FC device on the network if not already logged out Example emlxadm dev logout 21000020371938fa Done dev remove WWpn Removes the specified FC device from Solaris SF5 management Caution This command is not supported in the Solaris SFS stack and causes the host operating system to panic diag test parameters gt Performs the diagnostics function on the adapter port This command provides support for Emulex specific tests Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 27 Command Descriptions for emlxadm test parameters gt emlx biu pattern Performs the bus interface unit test The pattern parameter is a 4 byte hexadecimal pattern to be used for the test for example 0xA5A5A5A5 emlx echo did pattern Performs the echo test to a specified port id The emlx post Examples pattern parame
30. and Syntax Description Page get dump h Saves the firmware core dump to a file 31 get dump size Returns the adapter s firmware core dump size 31 get fcode rev Returns the current FCode revision of the adapter 31 get fw rev Returns the current firmware revision of the adapter 31 get hba attrs Returns the current control attributes for the adapter 31 get host attrs Displays all of the current host adapter API attributes 32 get host params Returns the FC login parameters of this adapter port 33 get inst Returns driver instance for this adapter port 34 get linkinfo Returns the current link status information for the adapter 34 port get logi params lt wwpn gt Returns the FC login common service parameters for a 34 specified FC device on the network get num devs Returns the number of FC devices currently seen by this 28 adapter port get path index Shows the current Solaris device path for a specified 35 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 index argument is an index into this list get phy attrs Shows the current PHY module attributes of the adapter 36 Note This command applies to UCNAs only get port attrs index Shows the current adapter API port attributes All of the 36 wwn all ports attributes can be displayed or a single port can be specified by index or wwn The total number
31. are q Exits this program h Returns this help screen hba Select another HBA p Repeat previous command emlxadm Entering emlxadm Commands After the available commands are listed the emlxadm gt prompt is displayed From this point the utility is prompt driven When the prompt is displayed you can enter one of the commands in the list For example you can display the list of available commands at anytime by typing h the help screen at the prompt emlxadm h For some commands you may have optional or required arguments If a command requires an argument but is entered without the argument a usage statement is returned to indicate that the command requires an argument s For example the get state command requires a WWPN for the target device Therefore if you type only get state emlxadm get state The emlxadm utility returns Usage get state lt wwpn gt Therefore you must include the lt wwpn gt argument for the get state command to receive a valid response for example emlxadm get state 21000020371938fa Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 49 CLI Mode of Operation for emlxadm The emlxadm utility can now run the command State PORT DEVICE LOGGED IN Exiting emlxadm 4 To exit quit the emlxadm utility type q at the prompt emlxadm q CLI Mode of Operation for emlxadm Th
32. are in the directory of the emlxu remove script go to step 4 Otherwise go to the directory where the original emlxu utilities package tar file is located cd directory 3 Extract the emlxu remove script from the emlxu utilities package tar file tar xf emlxu kit version sparc tar emlxu remove 4 Runthe emlxu remove script emlxu remove 5 The emlxu remove script locates the EMLXemlxu package and the following message is displayed Removing EMLXemlxu package If an emlxu utilities package is not found a message is displayed indicating this and you can skip to step 7 Otherwise you are prompted to remove the package Do you want to remove this package y n q n V Enter y The following message is displayed Removal of EMLXemlxu was successful 6 Thescript performs some cleanup and the following messages are displayed Removing emlxu scripts emlxu remove complete The utilities package has been removed 7 If you want to install another version of the emlxu utilities package follow the instructions provided in one of the following sections e Installing the Utilities for Solaris 10 on page 9 e Updating the Utilities on page 14 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 2 Installing and Removing Utilities 14 Removing the Utilities for Solaris 11 For more information on installing and removing packages see the Solaris system admi
33. d See Table 3 1 Summary for emlxadm cmd option s Various emlxadm command arguments if applicable Using emlxadm help for Command Usage in CLI Mode The emlxadm utility offers help for command usage in CLI mode To invoke a usage help screen type emlxadm help at the prompt The CLI mode usage screen is displayed as follows USAGE emlxadm or emlxadm v or emlxadm i lt N SFS FC or emlxadm j N SFS FC or emlxadm n N or all or emlxadm m N or all or emlxadm lt device path gt y OPTIONS y i N Executes instance iSFS Executes iFCT Executes iall Executes j N Executes instance jSFS Executes jFCT Executes jall Executes n N Executes instance nall Executes m lt N gt Executes instance mall Executes device path En or all A or all y cmd y cmd cmd command on Example command on command on command on command on Example command on command on command on command on Example command on command on Example command on If a full device path is not specified then th Runs utility in interactive mode y cmd cmd option s y cmd cmd option s cmd option s cmd option s cmd option s Display utility version information a specific emlxs driver N 2 for emlxs2 or N 2 1 for emlxs2 1 all SFS emlxs driver instances all FCT
34. d to choose one of the available adapter ports by entering its list number or you can type 0 or zero to exit Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 17 Interactive Mode of Operation for emlxadm Selecting an Adapter Port Attached to an SFS or FCT Stack If you select an adapter port that is attached to an SFS or FCT stack the emlxadm utility displays a list of available commands For example if you enter 1 from the example in Displaying Available Emulex Adapters on page 16 the emlxadm utility displays HBA 1 Available commands get num devs get dev list get logi params lt wwpn gt get host params get sym pname set sym pname string get sym nname set sym nname string dev login lt wwpn gt dev logout lt wwpn gt get state lt wwpn gt dev remove lt wwpn gt link status d id get fcode rev download fcode filename get fw rev download fw filename get boot rev get phy attrs download boot filename get dump size force dump h get_topology get_dump reset link wwpn reset hard diag ns parm get num parm get list parm get label parm set label val a11 get host attrs msgbuf number get port attrs lt index gt lt wwn gt all get path index get vpd boot code enable get rnid wwpn get inst get phy attrs set throttle Solaris FCA Utilities Version 1 08 5 0 User Manual
35. de WWN 20000000C942097E Node Symbolic Name none Hardware Version 1001206d Driver Version 1 11f t3 2006 04 25 11 43 Optional ROM Version 1 50a9 testl Firmware Version 1 91b5 Vendor Specific ID fc00 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 Fe Id 011700 Port Type Nport Port State Online Port Supported COS Class3 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 none Port Supported Speed 1Gb 2Gb Port Speed 1Gb Port Max Frame Size 0x800 bytes Fabric Name 0000000000000000 Number of Discovered Ports 4 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 LILPS 5 Hard Addr 0 WWPN 10000000c942097e WWNN 20000000c942097e Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 34 Command Descriptions for emlxadm 2G EMULEX get inst Returns driver instance for this adapter port Example emlxadm get inst
36. del is associated to only one of the FC drivers emlxs or elxfc at a time Likewise a specific NIC adapter model is associated to only one of the NIC drivers elxnic or oce at a time Notes e The simultaneous use of the Ipfc driver and either of the emlxs or elxfc drivers is not supported Using the Ipfc driver should only be used as a step when migrating complex configurations between drivers e If you change the driver binding configuration the emlxdrv utility requires a system reboot for the new configuration take effect e Oracle branded 16Gb adapters and the standard models share the same device id therefore it is not possible to bind them to two different drivers Both adapters must be bound to the same driver e If anOracle branded 16Gb universal host bus adapter is detected on the system the emlxdrv utility will only allow the adapter to bind with the emlxs driver The emlxdrv utility program can run in two modes e Interactive e CLI Interactive Mode of Operation for emlxdrv To run the emlxadm utility in interactive mode type emlxdrv without any commands or arguments For example emlxdrv Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 4 Using the emlxdrv Utility 52 2G EMULEX Interactive Mode of Operation for emlxdrv Displayi ng Bindings Between Drivers and Adapter Models The emlxdrv program scans the host system and prepares a driver configuration table consisting of bind
37. driver values are fc nic and driver name q Exits quits the emlxdrv utility 59 refresh Refreshes the host bindings and main display with the latest information 60 set Sets the specific driver emlxs elxfc lpfc elxnic or oce to bind to the specified 61 device s The set command has several options e set driver name all sets the driver name to bind to all devices 61 e set driver name dev alias sets the driver name to bind to the devices 61 specified by a valid adapter alias e set driver name emulex sets the driver name to bind to all 62 Emulex branded devices e Set driver name oracle sets the driver name to bind to all 62 Oracle branded devices The valid driver name values are emlxs elxfc lpfc elxnic or oce clear Clears the bindings from the specified driver s to the specified device s This command has various options as defined in the following subsections Note When running a clear command you may see a Cannot unload module message This message indicates that you must reboot the system to unbind a driver from that adapter alias The emlxdrv utility requires a system reboot for the new configuration take effect Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 56 4 Using the emlxdrv Utility 57 Command Descriptions for emlxdrv 2G EMULEX clear driver all Clears the bindings from the specified driver to all devices The valid driver val
38. e as detailed in Removing the Utilities Manually on page 14 Then manually Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2 Installing and Removing Utilities 2G EMULEX Updating the Utilities 19 install the newer EMLXemlxu utilities package as detailed in Installing the Utilities Manually on page 11 For Solaris 11 You can update the utilities package in two ways e Using the remote repository method run the pkg update emixu command e Using the p5p installation method follow either the script or the manual procedure in P5P Archive Installation on page 12 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 16 Interactive Mode of Operation for emlxadm 2G EMULEX 3 Using the emlxadm Utility The emlxadm utility changes driver parameters through a local interactive or CLI mode It can also update firmware on non Oracle branded devices The emlxadm utility is intended to be a direct user interface to the FCIO interface provided by the Oracle StorEdge SFS The FCIO interface provides a Oracle common ioctl interface to the FCTL driver which manages the FCA drivers for each Fibre Channel adapter attached to the host system The emlxadm utility program can run in two modes e Interactive mode see the following section e CLI mode see page 19 Note The OneCommand Manager application provides the same functions as emlxadm and a number of
39. ehe 19 Device Path Option in CLI Mode ciere rear re di 19 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2c EMULEX Table of Contents 4 Device Path Option for a Single Adapter o oocccccccconccnccnnnconconcnnonccancnnccnncannnss 19 Device Path Option for Multiple Adapters sssssssssessssssssessssssseseessssssseeeeesees 20 Instance Option in CLI Mode ooooooccccccccccccccccccncnnnnncncnccc conc nono ee nenne 21 Using emlxadm help for Command Usage in CLI Mode uueeeeeees 22 Command Descriptions for emlxadm cceeeeeeeeee eee eene e eene enhn 23 boot code enable disable vesical diia cena 26 nM eri LT iia 26 dev logout lt WWPN Saura VER FE ne VE EEE rE ERA VERE Vea VE isdus VV EEEE PEE XN VA VUE 26 dev remove WWDH sussescsecessst essi teshees sse doses doeed T Vua Ee EEE E ee ores Ve Dre e eo 26 diag test parameters gt siii epe EXE ES OR THRER AS AREE ERRAASAUA as 26 HAS COS lt CMALCO o 2 OPENED 27 download boot filename c cece ec ccc cece ec cee e e e nne e e e e eese nnns 27 download fcode filename ccc cece cece cc cee ene eecceeeeesceceeunceceeseuceseseueues 28 download fw filename ccc cece cece c cence ccc eeeeeeesceceeesceceeucesceeteucescseseues 28 force UMD ii DITIONES 29 get bOOL TEV cccicicie scene itore err eR e EN FUL cues IR EI sa 29 eMe AREE UA LIT IT 29 sve Mn PETIERE TU TI I TIT 30 get
40. el over Ethernet Fibre Channel Protocol Fibre Channel port provider module in Oracle COMSTAR stack Fibre Channel transport library host bus adapter internet 5mall Computer System Interface Loop Initialize ELS command manual e g man pages network interface card or controller physical layer module Request Node Identification Data ELS storage area network SAN Foundation Software Scalable Processor Architecture universal converged networking adapter vital product data World Wide Port Name 8 2 Installing and Removing Utilities Q DG EMULEX Compatibility 2 Installing and Removing Utilities Compatibility Before installing select the appropriate Solaris SFS operating system and then download the Solaris FCA utilities from the Emulex website The Emulex drivers for Solaris and Solaris FCA utilities support the following operating systems e Solaris 10 SPARC e Solaris 10 for x64 and x86 e Solaris 11 SPARC e Solaris 11 for x64 e Solaris 11 1 SPARC e Solaris 11 1 for x64 To determine which adapters are supported by the Solaris SFS FCA drivers emlxs and elxfc Solaris Ethernet NIC drivers oce and elxnic and the Solaris FCA utilities see the Emulex website Installing the Utilities for Solaris 10 The emlxadm and emlxdrv utilities are bundled into an emlxu utilities package You can install the emlxu utilities package in two ways e Using the emlxu install script see Installing the Utilities Using t
41. er of concurrent I Os that the driver can send to the specified remote port The default queue depth for an FCP target port is specified by the target depth driver parameter Command Options set throttle all depth Sets the depth for all ports set throttle fcp depth Sets the depth for all FCP target ports set throttle wwpn depth Sets the depth for a specific port Example This example sets the maximum number of concurrent I Os to 512 for all remote ports emlxadm set throttle all 512 WWPN Depth 21000011c6810947 512 21000011c681065f 512 21000011c68108c0 512 21000011c681061d 512 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 4 Using the emlxdrv Utility 54 Interactive Mode of Operation for emlxdrv 4 Using the emlxdrv Utility The emlxdrv utility binds associates the following FC and NIC drivers to various Emulex FC and NIC adapter models respectively FC Drivers e emlxs Solaris inbox FC FCoE driver e elxfc Emulex distributed FC FCOoE Solaris driver does not support Oracle branded devices e Ipfc Legacy Emulex distributed FC SD driver which does not support Oracle branded devices The Ipfc driver is available for Solaris 10 but not for Solaris 11 NIC Drivers e elxnic Emulex distributed Solaris NIC driver e oce Solaris inbox NIC driver The emlxs and elxfc FC drivers can coexist on the same host However a specific FC adapter mo
42. ere are two options available to run emlxadm in a CLI mode e Device path option see the following section e Instance option see page 21 Device Path Option in CLI Mode In this CLI mode option the user types emlxadm the device path followed by a valid command and its command arguments if applicable Syntax emlxadm device path y cmd cmd option s Arguments device path Specifies the full device name for a single adapter or a pattern string for multiple adapters If the pattern string matches any part of an adapter device path the command runs on that adapter y When the y option is included the emlxadm utility runs immediately without pausing for a verification from the user to continue When the y option is absent the emlxadm utility pauses for a verification from the user before running the command cmd An emlxadm command See Table 3 1 Summary for emlxadm Commands on page 23 cmd option s Various emlxadm command arguments if applicable Device Path Option for a Single Adapter When using the device path option for single adapters the device path parameter must be the full device name for the single adapter Running a Command with User Verification In this example the emlxadm utility pauses for a verification from the user before running the command The user types emlxadm the full device name devices pci le 600000 SUNW emlxs 2 fp 0 0 devct1 the command get state and
43. es Are you sure you want to download this image y or n y Downloading Done download fcode filename Downloads the specified FCode image file to the adapter Example emlxadm download fcode LP10000DC S fcode Image Components REL type size 33848 DWC file BOOT version 03841512 1 50a2 Current Fcode 1 50a2 New Fcode 1 05e 33848 0x8438 bytes Are you sure you want to download this image y or n y Downloading Result Operation successful Done download fw filename Downloads the specified firmware image file to the adapter Note The Emulex FCA driver does not allow a firmware update to Oracle branded adapters Example emlxadm 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 90a4 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 29 Command Descriptions for emlxadm 2G EMULEX New Firmware 1 05e 366712 0x59878 bytes Are you sure you want to download this image y or n y Downloading Done force dump Forces a firmware core dump on the adapter Example emlxadm force dump Done get boot rev Returns the current boot revision of the ada
44. gt EMULEX CLI Mode of Operation for emlxdrv Table 4 2 NIC Driver Configuration Table Heading Descriptions Heading Description oce A yes indicates the oce driver supports this specific type of adapter elxnic A yes indicates the elxnic driver supports this specific type of adapter Models See the Models description in Table 4 1 on page 53 Entering emlxdrv Commands After the available commands are listed the emlxdrv gt prompt is displayed From this point the utility is prompt driven When the prompt is displayed you can enter one of the commands in the list For example to refresh the host bindings and main display with the latest information use the refresh command emlxdrv refresh The current driver configuration table and the available command list are displayed automatically after each command is issued Some commands require a driver or driver name and an alias 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 Exiting emlxdrv 4 HH To exit quit the emlxdrv utility type q at the prompt emlxdrv q CLI Mode of Operation for emlxdrv You can run the emlxdrv utility program in CLI mode by typing the name of the program followed by a valid command and any re
45. he emlxu install Script on page 9 e Manually by using pkgadd see Installing the Utilities Manually on page 11 Installing the Utilities Using the emlxu install Script Note Although it is possible to install emlxu onto one or more clients from a server that procedure is not covered in this document see the Solaris documentation Before installing the emlxu utilities package you must install the Solaris 10 Update 9 or later with Oracle recommended patches Make sure the emlxs or elxfc driver is v2 60k or later and the oce driver is v1 10e or later If an earlier version of the emlxu utilities package is installed in the following procedure you are prompted to remove it before the script installs the new version To install the emlxu utilities package using the emlxu install script 1 Login as root or su to root 2 Copy the emlxu utilities package from your distribution medium into a directory The emlxu utilities package is a tar file with a name in the following format emlxu kit version sparc tar 3 Change to the directory of the tar file cd directory Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A e 2 Installing and Removing Utilities 10 DG EMULEX Installing the Utilities for Solaris 10 4 Extract the emlxu_install script from the tar file tar xf emlxu kit version sparc tar emlxu install 5 Install the emlxu utilities package emlxu install If an earlie
46. ings associations between the FC and NIC drivers emlxs elxfc Ipfc oce and elxnic and a list of Emulex FC and NIC adapter models After the table is prepared the utility displays FC driver configuration table NIC driver configuration table List of available commands emlxdrv prompt For example after emlxdrv is entered the utility displays the following FC Dri elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc emlxs emlxs emlxs emxls elxfc elxfc NIC Dr oce elxnic ver Alias Pres Boot Oracle emlxs elxfc lpfc Models lpfs B yes yes yes LP8000S LP9002S SBUS 800 yes yes yes LP8000 LP8000DC f900 yes yes yes P9002 LP9002C P9002DC LP9402DC f980 S S S LP9802 LP9802DC fa00 S S S LP10000 LP10000DC LP10000ExDC fd00 x S S S LP11000 LP11002 fe00 yes yes yes yes LPe11000 LPe11002 LPe11004 fel2 yes yes yes LPe11000 LPe11002 LPe11004 f100 yes yes yes Pe12000 LPe12002 fill yes yes yes LPe12000 LPe12002 f112 yes yes yes Pe12000 LPe12002 fe05 yes yes yes LP21000 LP21002 f0a5 yes yes 2G Blade Adapter PoUD gt yes yes B LP10000 S LP10000DC S fcl0 yes yes yes LP11000 S LP11002 8 fc20 yes yes LPe11000 S LPe11002 S fc40 B yes yes LPe12000 S LPe12002 S 704 E ye
47. iptions for emlxadm 37 00000000 00000000 00000000 00000000 0004 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 0004 00000000 00000000 00000000 00000000 P009430 01A Rev A 2G EMULEX Port Supported COS Port Supported FC4 Types Port Active FC4 Types Port Symbolic Name Port Supported Speed Port Speed Port Max Frame Size Fabric Name Port 3 Attributes Node WWN Port WWN Port Fc Id Port Type Port State Port Supported COS Port Supported FC4 Types Port Active FC4 Types Port Symbolic Name Port Supported Speed Port Speed Port Max Frame Size Fabric Name get_rnid wwpn 3 Using the emlxadm Utility 38 Command Descriptions for emlxadm Class3 00000000 00000000 00000000 00000000 00000000 00000000 SEAGATE ST39103FC 00000000 00000000 00000000 00000000 00000000 00000000 0004 00000000 00000000 00000000 00000000 Unknown Unknown 0x0 bytes 0000000000000000 2000002037193670 2100002037193670 0113e8 Unknown Unknown Class3 00000000 00000000 00000000 00000000 00000000 00000000 SEAGATE ST39103FC 00000000 00000000 00000000 00000000 00000000 00000000 0004 00000000 00000000 00000000 00000000 Unknown Unknown 0x0 bytes 0000000000000000 Returns the Request Node Identification Data ELS information fo
48. lation Scripted Installation 1 2s 3 Log in as root or su to root Download the p5p tar file from the Emulex website Untar the archive tar xvf emlxu p5p 1 08 4 0 tar Run the installation script emlxu install Manual Installation Solaris FCA Utilities Version 1 08 5 0 User Manual Log in as root or su to root Download the p5p tar file from the Emulex website Extract the p5p archive from the tar file tar xvf emlxu p5p 1 08 4 0 tar Run the following command to install the package pfexec pkg install g emlxu 1 08 4 0 p5p emlxu P009430 01A Rev A 2 Installing and Removing Utilities f 13 2G EMULEX Removing the Utilities for Solaris 10 5 Reboot the system reboot Removing the Utilities for Solaris 10 You can remove the emlxu utilities package in three ways e Using the emlxu install script removes any previous versions of the emlxu utilities package before installing the latest emlxu utilities package See Installing the Utilities Using the emlxu install Script on page 9 e Using the emlxu remove script removes all emlxu files See Removing the Utilities Using the emlxu remove Script on page 13 e Manually by using pkgrm removes all emlxu files See Removing the Utilities Manually on page 14 Removing the Utilities Using the emlxu remove Script To remove all emlxu files using the emlxu remove script 1 Loginas root or su to root 2 Ifyou
49. meters parm get list Returns a list of configurable parameters parm get label Gets the value of a specified parameter in the driver parm set label val Sets the value of a specified parameter in the driver msgbuf all number 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 index 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 get phy attrs Returns the current PHY attributes for the HBA CNA s only set throttle Temporarily sets the I O queue depth for a specified remote port get throttle Gets the I O queue depth for all remote ports q Exits this program h Returns this help screen hba Select another hba p Repeat previous command emlxadm hba Selects another adapter with which to interface This command allows you to connect to another adapter without having to exit and re enter the program Example emlxadm hba Available Emulex HBA s 1 SFS emlxs0 devices pci 7c0 pci 0 pci l pci 0 2 SUNW em1lxs 1 fp 0 0 CONNECTED 2 FCT emlxsl devices pci87c0 pci80 pci81 pciQ0 2 SUNW emlxs81 1 CO
50. nd has various options as defined in the following subsections Note When running a set command you may see a Cannot unload module message This message indicates that you must reboot the system to unbind a driver from that adapter alias The emlxdrv utility requires a system reboot for the new configuration take effect set driver name all Sets the specified driver name to bind to all devices The valid driver name values are emlxs elxfc Ipfc elxnic or oce Example emlxdrv gt Updating Updating Updating set emlxs all lpfs 800 900 Cannot unload module lpfc Will be unloaded upon reboot Updating f980 Cannot unload module lpfc Will be unloaded upon reboot U pda pda pda pda pda pda ting ting ting ting ting ting Done fa00 d00 fe00 fc00 fc10 fc20 set driver_name alias Sets the specified driver_name to bind to the devices specified by a valid adapter alias as listed in one of the driver configuration tables see the Alias column in Table 4 1 on page 53 Note that each alias is shared by multiple adapter models Driver bindings Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 4 Using the emlxdrv Utility 62 Command Descriptions for emlxdrv 2G EMULEX can be made only with an adapter alias and not with a specific adapter model The valid driver name values are emlxs elxfc Ipfc elxnic or oce Example
51. nistration documentation and the pkgadd 1M and pkgrm 1M man pages Removing the Utilities Manually To manually remove the EMLXemlxu utilities package 1 Login as root or su to root 2 Run the package removal command pkgrm EMLXemlxu 3 You are prompted to confirm the package removal Do you want to remove this package y n q n V Enter y The package is prepared for removal 4 You are prompted again for confirmation Do you want to remove this package y n q Mo Enter y The following message is displayed Removal of lt EMLXemlxu gt was successful For more information on installing and removing packages see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M man pages Removing the Utilities for Solaris 11 Manual Removal Run the following command to remove emlxu from the system pkg uninstall emlxu Scripted Removal Run the following command to remove emlxu from the system emlxu remove Updating the Utilities For Solaris 10 You can update the utilities package in two ways e Using the emlxu install script follow the procedure in Installing the Utilities Using the emlxu install Script on page 9 In this procedure if an earlier version of the emlxu utilities package is installed you are prompted to remove it before installing the newer version e Manually first manually remove the existing EMLXemlxu utilities packag
52. not already logged out dev remove lt wwpn gt Removes the specified FC device from Solaris SFS 26 management Caution This command is not supported in the Solaris SFS stack and causes the host operating system to panic diag Performs a diagnostic test on the adapter Two formats are 26 available diag test parameters gt Performs a diagnostic test on the adapter port specified by an Emulex specific test and its parameters if applicable diag code lt cmd_code gt 27 Performs a diagnostic test on the adapter port specified by a diagnostic command code in hexadecimal This command provides generic support to issue an adapter specific diagnostic code to any third party adapter download boot filename Downloads the specified boot image file to the adapter 27 download fcode filename Downloads the specified FCode image file to the adapter 28 download fw filename Downloads the specified firmware image file to the adapter 28 force dump Forces a firmware core dump on the adapter 29 get boot rev Returns the current boot revision of the adapter 29 get dev list Returns a list of FC devices currently seen by this adapter 29 port Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A ne e 3 Using the emlxadm Utility 24 gt EMULEX Command Descriptions for emlxadm Table 3 1 Summary for emlxadm Commands Continued Comm
53. nto this list Example emlxadm get path 0 Adapter pci le 600000 SUNW emlxs 2 fp 0 0 emlxadm gt get path 1 Adapter pci le 600000 SUNW emlxse2 1 fpe0 0 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A Command Descriptions for emlxadm 2G EMULEX 3 Using the emlxadm Utility 36 get_phy_attrs Shows the current physical layer module attributes of the HBA This command applies to UCNAs only Example emlxadm get phy attrs PHY Attributes PHY Type XAUI Interface Type CX4 10 GB Flags 0x00000000 get port attrs index wwn all Shows the current adapter API port attributes All of the ports attributes can be displayed or a single port can be specified by index 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 index argument is an index into this list Example emlxadm 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 Port Active FC4 Types 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Port Symbolic Name none Port Supported Speed 1Gb 2Gb Port
54. nually 1 2 Log in as root or su to root Copy the emlxu utilities package from your distribution medium into a directory The emlxu utilities package is a tar file with a name in the following format emlxu kit version sparc tar Go to the directory of the tar file cd directory Extract the emlxu install script from the tar file tar xvf emlxu kit version sparc tar Install the EMLXemlxu utilities package pkgadd d EMLXemlxu The package is prepared for installation and you are prompted to confirm its installation Do you want to continue with the installation of lt EMLXemlxu gt y n mM Enter y 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 EMLXemlxu 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 EMLXemlxu man to the system environment s man path For more information on installing and removing packages
55. of ports available can be seen in the Number of Discovered Ports attribute displayed using the get host attrs command The index argument is an index into this list get rnid wwpn Returns the RNID information for the local or specified port 38 get state lt wwpn gt Returns the current Solaris SFS state of the specified FC 39 device on the network get sym nname Returns the symbolic FC node name of the adapter port 39 Note This operation is not supported by the Solaris SFS stack get sym pname Returns the symbolic FC port name of the adapter port 39 Note This operation is not supported by the Solaris SFS stack get throttle Returns the I O queue depth of all remote ports 39 get topology Returns the FC network topology of the adapter port 40 get vpd Shows the current adapter s vital product data 40 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 25 Command Descriptions for emlxadm Table 3 1 Summary for emlxadm Commands Continued Command Syntax Description Page h Returns the help screen that is it lists the available 40 commands hba Allows you to select another adapter with which to 41 interface This prevents you from having to exit and reenter the program link status d id Requests and returns the current link error status from the 42 FC device specified by the D ID address
56. ote The emlxdrv utility 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 Oracle A yes indicates that this specific type of adapter is branded and sold directly by Oracle emlxs A yes indicates the emlxs driver supports this specific type of adapter elxfc A yes indicates the elxfc driver supports this specific type of adapter lpfc A yes indicates the lpfc driver supports this specific type of adapter Models 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 The definitions of headings for the NIC driver configuration table Table 4 2 NIC Driver Configuration Table Heading Descriptions Heading Description NIC The type of NIC driver oce or elxnic that is currently configured to bind or attach to a Driver specific adapter alias Alias See the Alias description in Table 4 1 on page 53 Pres See the Pres description in Table 4 1 on page 53 Oracle See the Oracle description in Table 4 1 on page 53 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 4 Using the emlxdrv Utility 54
57. pter Example emlxadm get boot rev Firmware revision LP10000DC S 1 90a3 get dev list Returns a list of FC devices currently seen by this adapter port Example emlxadm get dev list Dtype 0 FC4 type proto 0x00000100 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 State Logged In D id 113e1 LILP 0 Hard Addr el WWPN 21000020371938fa WWNN 20000020371938fa Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX FC4 type proto State D id LILP Hard Addr WWPN 0x00000100 0x00000000 Logged In 113e2 0 e2 21000020371939a2 20000020371939a2 0x00000000 0x00000000 3 Using the emlxadm Utility Command Descriptions for emlxadm 30 0x00000000 0x00000000 0x00000000 0x00000000 Device 2 Dtype FC4 type proto State D id LILP Hard Addr WWPN 0x00000100 0x00000000 Logged In 113e4 0 el 21000020371938a3 20000020371938a3 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 Device 3 Dtype FC4 type proto State D_id LILP Hard Addr WWPN WWNN get dump h 0x00000100 0x00000000 Logged In 113e8 0 e8 2100002037193670 2000002037193670 0x00000000 0x00000000 Saves the firmware core dump to a file Example 0x00000000 0x00000000 0x00000000 0x00000000 Result if a valid dump exists in the driver memory
58. quired command arguments For example emlxdrv refresh This mode of operation enables you to use the emlxdrv utility as part of a script or another program capable of running system level calls For example you can revise the device binding by entering all the information on one line at the operating system prompt as shown below FC Driver Alias Pres Boot Oracle emlxs elxfc lpfc Models elxfc lpfs yes yes yes LP8000S LP9002S SBUS elxfc f800 yes yes yes LP8000 LP8000DC elxfc 900 yes yes yes P9002 LP9002C P9002DC LP9402DC elxfc f980 yes yes yes LP9802 LP9802DC Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc emlxs emlxs emlxs emxls elxfc elxfc fa00 d00 fe00 fel2 f100 f111 f112 fe05 f0a5 fc00 fc10 fc20 fc40 704 714 yes yes yes NIC Driver Alias oce elxnic 700 710 4 Using the emlxdrv Utility 55 CLI Mode of Operation for emlxdrv yes yes y LP10000 LP10000DC LP10000ExDC B B yes yes y LP11000 LP11002 yes yes y LPe11000 LPe11002 LPe11004 yes yes y LPe11000 LPe11002 LPe11004 B yes yes y Pe12000 LPe12002 yes yes y Pe12000 LPe12002 yes yes y LPe12000 LPe12002 B yes yes y LP21000 LP21002 yes yes 2G Blade Adapter yes
59. r the local or specified port Example emlxadm get rnid Offset 00 01 02 03 04 05 06 07 0 31 30 30 30 30 30 30 30 10 00000007 00 00 00 00 20 00000000 00 00 00 00 30 00 00 00 00 Done Solaris FCA Utilities Version 1 08 5 0 User Manual 08 09 0A OB 0C OD OE OF ASCII 63 39 34 63 62 64 34 65 10000000c94cbd4e 00 00 00 00 00 OT OQ O0 uses aci nk as 00 00 00 00 00 00 00 00 2 9 A8 P009430 01A Rev A Command Descriptions for emlxadm 2G EMULEX 3 Using the emlxadm Utility 39 get state lt wwpn gt Returns the current Solaris SFS state of the specified FC device on the network Example emlxadm get state 21000020371938fa State PORT DEVICE LOGGED IN get sym nname Returns the symbolic FC node name of the adapter port Note This operation is not supported by the Solaris SFS stack Example emlxadm get sym nname ioctl FCIO GET SYM NNAME Operation not supported get sym pname Returns the symbolic FC port name of the adapter port Note This operation is not supported by the Solaris SFS stack Example emlxadm get sym pname ioctl FCIO GET SYM PNAME Operation not supported get throttle Returns the I O queue depth of all remote ports The queue depth represents the maximum concurrent I Os the driver allows to the remote port at any given time The default queue depth for an FCP target port is specified by the target depth driver parameter Example emlxadm
60. r version of the emlxu utilities package is not found a message is displayed indicating this and you can skip to step 7 Otherwise the script begins removing any earlier version of the emlxu utilities package and the following message is displayed Removing old EMLXemlxu package 6 Ifanearlier version of the emlxu utilities package is installed you are prompted to remove it Do you want to remove this package y n q n n Enter y The following message is displayed Removal of EMLXemlxu was successful 7 Thescript expands the new tar file and begins installing the emlxu utilities package The following message is displayed Expanding emlxu kit version sparc tar Adding new package The package is prepared for installation and you are prompted to confirm its installation Do you want to continue with the installation of lt EMLXemlxu gt ly ny 2 Mo Enter y The installation progress is indicated 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 EMLXemlxu was successful The script performs some cleanup and the following messages are displayed lt Cleaning directory gt lt emlxu install complete gt lt Execute emlxu remove when ready to uninstall gt The script copies the emlxu_remove script into the working directory with
61. rameter in the driver Returns the driver s internal message log Returns the host adapter and port attributes he t Returns t Returns the t S port attributes adapter path Returns he adapter s Vital Product Data VPD Sets or shows the boot code state in this HBA Gets the Gets the Returns the current PHY attributes for the HBA CNA s only RNID information for local or specified port driver instance Temporarily sets the I O queue depth for a specified remote port P009430 01A Rev A 3 Using the emlxadm Utility 18 gt EMULEX Interactive Mode of Operation for emlxadm get_throttle Gets the I O queue depth for all remote ports a Exits this program h Returns this help screen hba Select another hba p Repeat previous command emlxadm Selecting an Adapter Port Attached to a NIC Stack If you select an adapter port that is attached to a NIC stack the emlxadm utility presents a list of available commands For example if you enter 2 from the example in Displaying Available Emulex Adapters on page 16 the emlxadm utility displays HBA 2 devices pci 0 0 pcildde 5d c pcilddf e602 0 physical port Available commands NIC revl1 get hba attrs Returns the current control attributes for the HBA get linkinfo Returns the current link status information for the HBA port get fw rev Returns the current firmware revision of the HBA download fw filename Download the HBA firmw
62. s yes OCe10101 OCe10102 714 yes yes yes OCe11101 OCe11102 iver Alias Pres Oracle oce elxnic Models 700 yes yes OCe10101 OCe10102 710 yes yes OCel11101 0OCe11102 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX Available Sets clear refresh q emlxdrv gt 4 Using the emlxdrv Utility 53 Interactive Mode of Operation for emlxdrv Commands Sets driver bindings to specified devices Clears driver bindings to specified devices Refresh driver bindings to current devices Exits this program The definitions of headings for the FC driver configuration table Table 4 1 FC Driver Configuration Table Heading Descriptions Heading Description FC The type of FC driver emlxs elxfc lpfc or for none that is currently configured to Driver bind or attach to a specific adapter alias Alias 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 Pres A yes indicates that this type of adapter is currently present in the host system The emlxdrv utility allows you to bind a driver to adapters that are not currently present in the system but may be present in the future Boot A yes indicates that this specific type of adapter is currently providing connectivity to the system s boot disk N
63. see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M man pages Installing the Utilities for Solaris 11 Note Do not install the Emulex Solaris FCA Utility Kit emlxu from the p5p bundle or IPS repository on any host that has OCM installed Remove the OCM kit Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX 2 Installing and Removing Utilities 12 Installing the Utilities for Solaris 11 before installing emlxu using p5p If you want to run both OCM and emlxu use the combined installation kit Remote Repository Installation Log in as root or su to root Add the Emulex IPS repository to the publisher list pkg set publisher O http lt repository url emulex List all available versions of emlxu pkg list af emlxu NAME PUBLISHER VERSION IFO emlxu emulex 1 8 4 0 0 emlxu emulex 1 923 090 By default the newest version of emlxu that is compatible with the rest of the image will be installed On the system whose output was displayed in step 2 the following command will install version 1 8 4 0 0 pfexec pkg install emlxu To install a specific version of emlxu append the package version to the package name as follows pfexec pkg install emlxu 1 8 3 0 0 In instances where two publishers provide packages of the same name specify the publisher name as follows pfexec pkg install emulex emlxu P5P Archive Instal
64. steeees 12 P5P Archive Installation e ee oerte uar ey vr erroe geo sU Vr EE Er EUN e 12 Scripted Installati n e wanacalenee 12 Manual Installation ewm 12 Removing the Utilities for Solaris 10 ooooccoccrccccnonccccnnccnccccocccccccncccccccncoss 13 Removing the Utilities Using the emlxu remove Script seueeeeeeueee 13 Removing the Utilities Manually eceeeeeeeeee eene enne nnne 14 Removing the Utilities for Solaris 11 ooooococccccccnnnccccnnnonacccaconccccnccccnncncoos 14 Manual Removal ooccccccccccccncncnccccconc sees nnn ehh een 14 Scripted Removal cerrar RARE E EVE S ERU IEEE VELO SERVE NE 14 Updating the Utilities roodo rr idas cdi 14 For Solaris P 14 FOr Solaris 14 P es 15 3 Using the emlixadm UE AAA RARA 16 Interactive Mode of Operation for emlxadm eeeeeee eee ee eee nennen 16 Displaying Available Emulex Adapters eeeeeeeeeeee eene 16 Selecting an Adapter Port Attached to an SFS or FCT Stack eeesss 17 Selecting an Adapter Port Attached to a NIC Stack cee cece eee ec cece eneeeeeeees 18 Entering emlxadm Commands adi 18 Exiting emlxadm esee ks ee e rne reno EESE n TEES SERRE TREE ER EUER 19 CLI Mode of Operation for emlxadm ceeeeeeeeeeeee eene eene
65. sumes 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 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2c EMULEX Table of Contents 3 Table of Contents Listof Tables cui aia cds 6 Le INCPORPU CLIO rv 7 e iar A D 7 Pj fe 7 Supported Drivers 4 eere uror eror ren o e n pUE PE secon aware eines sap auda sau sss UU eU o Ua 7 ADDIOVIAVIONS Mem Un 7 2 Installing and Removing Utilities Leeeeee eee e eee eene eene eene 9 eral 9 Installing the Utilities for Solaris 10 ceeeeeee eee eene neenon 9 Installing the Utilities Using the emlxu install Script ueeeeueeeeeueees 9 Installing the Utilities Manually eesssssssssseeeee meme 11 Installing the Utilities for Solaris 11 ieaceeioesi ec ius neris eoo upa ee eR RE up cR ER RECEN EUREN 11 Remote Repository Installation cccccce eee eeseecceeeeeeeeeeeeeeeeeesssaeeese
66. t of an adapter device path the command runs on that adapter Running a Command with User Verification In this example the emlxadm utility pauses for a verification from the user before running the command The user types emlxadm the pattern string SUNW emlxsQ2 and the command get_num devs emlxadm SUNW emlxs 2 get num devs The elxadm utility returns some status but pauses for a response before running the command 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 mM After the user types y the elxadm utility returns more information but again pauses for a response before running the command There are 5 devices reported on this port Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 241 CLI Mode of Operation for emlxadm 2G EMULEX HBA port devices pci le 600000 SUNW emlxs 2 1 fp 0 0 devetl gt Do you wish to continue with this device y n q y Mo After the user types y the emlxadm utility runs the command There are 0 devices reported on this port Running a Command without User Verification Using y If you do not want the emlxadm utility to pause for verification before running the command include the y option after the pattern string For example when the user types emlxadm the y option
67. ter is a 4 byte hexadecimal pattern to be used for the test for example OXA5A5A5AD Performs the power on self tests Performs the bus interface unit test emlxadm Result diag emlx biu EMLX DIAG BIU Operation successful Performs the echo test to a did fffffc emlxadm Result diag emlx echo fffffc EMLX DIAG ECHO Operation successful Performs the power on self tests emlxadm Result diag emlx post EMLX DIAG POST Operation successful diag code cmd code Performs a diagnostic test on the adapter port specified by a diagnostic command code in hexadecimal format This command provides generic support to issue an adapter specific diagnostic code to any third party adapter Note The return status from the adapter is displayed in decimal and hexadecimal format if the diagnostic command code is valid for the adapter No interpretation of the return status is provided Examples emlxadm diag code 0x4526 Result CODI E 0x4526 16 0x10 download boot filename Downloads the specified boot image file to the adapter Example emlxadm download boot TD190A4 PRG Image Components REL type size 143416 DWC file BOOT version 03845054 1 90a4 Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 3 Using the emlxadm Utility 28 Command Descriptions for emlxadm 2G EMULEX Current Boot 1 90a3 New Boot 1 90a4 143416 0x23038 byt
68. the pattern string and the command the elxadm utility runs the command immediately emlxadm SUNW emlxs 2 y get num devs 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 Instance Option in CLI Mode This CLI mode option enables you to use the emlxadm utility as part of a script or another program capable of running system level calls Syntax emlxadm i lt N SFS FCT or all gt y cmd cmd_option s Arguments N Indicates a specific emlxs driver instance For example N 1 means emlxs1 N 2 means emlxs2 and N 2 1 means emlxs2 1 SFS Indicates all emlxs driver instances that are attached to the Oracle SFS interface FCT Indicates all emlxs driver instances that are attached to the Oracle COMSTAR interface all Indicates all emlxs driver instances y When the y option is included the emlxadm utility runs immediately It does not pause for a verification from the user to continue When the y option is absent the emlxadm utility pauses for a verification from the user before running the command Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX cmd Commands on page 23 3 Using the emlxadm Utility 22 CLI Mode of Operation for emlxadm An emlxadm comman
69. trators this document includes information about installing and removing these utilities System administrators should be familiar with Solaris and the Oracle StorEdge SAN Foundation Software SFS and should have access to standard system documentation Anyone working with this product should be familiar with the Emulex OneConnect universal converged networking adapter UCNA as well as FC and Ethernet technologies Supported Drivers Emulex emlxadm and emlxdrv utility programs support the following FC and NIC drivers e emlxs Solaris inbox Fibre Channel Fibre Channel over Ethernet FC FCoE driver e elxfc Emulex distributed FC FCOE Solaris driver does not support Oracle branded devices e Ipfc Legacy Emulex distributed FC SD driver which does not support Oracle branded devices The Ipfc driver is available for Solaris 10 but not for Solaris 11 e oce Solaris inbox NIC driver e elxnic Emulex distributed Solaris NIC driver Abbreviations API application programming interface CLI Command line interface D ID destination identifier ELS Extended Link Service Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 2G EMULEX FC FCA FCIO FCoE FCP FCT FCTL HBA iSCSI LINIT man NIC PHY RNID SAN SFS SPARC UCNA VPD WWPN Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 1 Introduction Abbreviations Fibre Channel Fibre Channel adapter FC input output Fibre Chann
70. ues are fc nic and driver name as defined in the following section Command Options clear all Clears bindings from all drivers to all devices This is the default value for the clear command clear fc all Clears bindings from FC drivers to all devices clear nic all Clears bindings from NIC drivers to all devices clear driver name all Clears bindings from a specific driver indicated by its name to all i devices Example emlxadm clear all Updating lpfs Cannot unload module emlxs Will be unloaded upon reboot Updating f800 Cannot unload module emlxs Will be unloaded upon reboot Updating 900 Cannot unload module lpfc Will be unloaded upon reboot Updating f980 Cannot unload module lpfc Will be unloaded upon reboot Updating fa00 Cannot unload module emlxs Will be unloaded upon reboot Updating fd00 Cannot unload module emlxs Will be unloaded upon reboot Updating fe00 Cannot unload module emlxs Will be unloaded upon reboot Solaris FCA Utilities Version 1 08 5 0 User Manual P009430 01A Rev A 4 Using the emlxdrv Utility 58 Command Descriptions for emlxdrv 2G EMULEX Done clear dev alias Clears the bindings from a valid adapter alias as listed in one of the driver configuration tables see the Alias column in Table 4 1 on page 53 to its associated devices Each alias is shared by multiple adapter models Example emlxdrv clear dev fe00 Updating fe

Solaris FCA Utilities Version 1.08.5.0 User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents