Home

Solaris FCA Utilities Version 2.90.10.0 User Manual

1. ceeeeeeeeeee eee eene eee enhn 19 Device Path Option in CLI Mode iui isse se rara ure v VERE a ER DEA YR ANEN Raw a Ra aguas 19 Device Path Option for a Single Adapter ne e 20 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2c EMULEX Table of Contents 4 Device Path Option for Multiple Adapters cccce eee c cence ee eeeecenneeeeeeeeeeeeeeaes 20 Instance Option in CLI Mode 21 Using emlxadm help for Command Usage in CLI Mode 22 Command Descriptions for emlxadrm 45 22 eno ee no ran NES RK REK ENEE NES EE EE NEES 23 boot code enable disable 14 5 24 cra oorr nro ro ken rey aa ERR ER ra Rx Ya axVaudn 27 dev logini SW WPI EE 27 dev logout sWWDIP iuis paced EE Ee 27 dev remove WWDIIP edd cae eese eek o pee Rer RE RA NN ENERO ES Re EFE REESE E ENSE ERE AEN e EEN 27 diag lt test parameters EE 27 diag code cmd code 28 download boot filename scssosssssesesosessssseseososssesesssososesesssesersssssesse 28 download fcode filename ccsssseeeseseeeeeeeeee n e e e e e ese e nnns 29 download fw filename cc ccc cece ccc cence ccc eeeeeeesceeeecsceceeucceeeeteucescseseues 29 force dump EE 30 Set DoOL FEN seh gedet NN dE ANEN de eae eae se gedd Ee ANA ed 30 get dev SE geregelt 30 eet dump FN uestes esses ur ETE EUR E EXTEAREIVREETS adage awesomeness 31 set dump Size ege Nee E ET RR e REVISAR ENNEN ed 32 get fCode EE 32 get PW EN ee E
2. cccceeeecce cece eee eeeeeessssseeeeeeeeeeeeeeeeesessaganenees 49 EPE EE EATE E N E uous dvo c UDeDe RP EE TE ET 49 reset Mal a E A ee 50 reset link wwpn Of ociuiisise soar au pug REA YE DRE EE REA Y Xx av Vo Y Rua od via X Ea bu a VER 50 set sym nname string icsscece Ee sese eae ege Ve adesse s s eee s e vo repe A ENN 50 set sym pname Tetrings sn esses 50 Ee le e RE mM 51 4 Using the emlxdry Utility asas eo assh eaae rea aya ERR RR EIER ER ER S n ER E ER ANEN 52 Interactive Mode of Operation for emlxdrv eeeee esee ee eee eene eene nnne 52 Displaying Bindings Between Drivers and Adapter Models 53 Entering emlxdrv Comnmlands iiiiseesanv E pasue xa v eege ERRARE REQYWRR WR E RR RE ES 55 Eet DN T 55 CLI Mode of Operation far GREEN ne SEENEN PER NS 55 Command Descriptions for emlxdrv e ENEE esee eee eee eene nhe hene 56 CLO OM T 57 Clear driver all cc 57 clear dev EE 59 clear driver emuleX eiae sno are AEAEE epe Sea AANEEN OSEERE NERA ANERER MEER ES 59 clear driver Oracle LE 60 a E E SEENEN 60 ee E 61 e EE 62 set driver NAME All entere ertet tto ne eye eh uE en mex hr uer HU EE e e FOR PE rere PEE 62 set driver name alias 5 55 prre terne rye KEEN E de gaere dens AE Get 62 set driver name
3. 0004 00000000 00000000 00000000 00000000 P009694 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 39 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 for 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
4. P5P Archive Installation on page 12 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 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 an 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 Interactive Mode of Operation for emlxadm in the following section e CLI mode see CLI Mode of Operation for emlxadm on page 19 Note The OneCommand Manager application 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 Interactive Mode of Operation for emlxadm To run the emlxadm utility in interactive mode type emlxadm without any command line arguments For example f 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 t
5. 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 OCe11102 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 52 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 4 Using the emlxdrv Utility 57 Command Descriptions for emlxdrv 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 57 clear command has several options e 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 59 devices e clear driver emulex clears bindings from the specified driver to all 59 Emulex branded devices e clear driver oracle clears bindings from the specified driver to all 60 Oracle branded devices The valid driver values are fc nic and driver name
6. 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 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility 29 Command Descriptions for emlxadm 2G EMULEX Current Boot 1 90a3 New Boot 1 90a4 143416 0x23038 bytes 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
7. clear refresh q Sets driver bindings to specified devices Clears driver bindings to specified devices Refresh driver bindings to current devices Exits this program Solaris FCA Utilities Version 2 90 10 0 User Manual pts yes yes yes LP8000S LP9002S SBUS 800 yes yes yes LP8000 LP8000DC 900 x x yes yes yes LP9002 LP9002C LP9002DC LP9402DC 980 x yes yes yes P9802 LP9802DC fa00 yes yes yes LP10000 LP10000DC P10000ExDC fd00 yes yes yes LP11000 LP11002 fe00 yes yes yes yes LPe11000 LPe11002 LPe11004 fel2 yes yes yes LPe11000 LPe11002 LPe11004 100 yes yes yes LPe12000 LPe12002 EE yes yes yes LPe12000 LPe12002 f112 yes yes yes LPe12000 LPe12002 fe05 yes yes yes LP21000 LP21002 f0a5 x x yes yes 2G Blade Adapter fc00 yes yes LP10000 S LP10000DC S fc10 yes yes yes LP11000 S LP11002 S fc20 yes yes zi LPe11000 S LPe11002 S fc40 yes yes LPe12000 S LPe12002 S 704 yes yes OCe10101 0OCe10102 714 yes yes yes x 0Ce11101 OCe11102 Alias Pres Oracle oce elxnic Models 700 yes yes OCe10101 OCe10102 710 yes yes OCel11101 OCe11102 P009694 01A Rev A 4 Using the emlxdrv Utility 62 Ces EMULEX Command Descriptions for emlxdrv set This command sets the bindings from the specified driver emlxs elxfc Ipfc elxnic or oce to
8. 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 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility 30 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 adapter 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 emlxa
9. 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 2 90 10 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 Descriptions for emlxadm 38 00000000 00000000 00000000 00000000 0004 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
10. 241 DG EMULEX CLI Mode of Operation for emlxadm 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 nu n 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 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 Hu Vn After the user types y the emlxadm utility runs the command and displays the result 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 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
11. 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 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX Available Sets clear refresh q emlxdrv gt 4 Using the emlxdrv Utility 54 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 Note The emlxdrv utility does not all
12. ENET TEEN e AE E ERER 32 get hba 9 EES A Zeg a DANN NEE E ae ENNER E T E E E 32 get host att s sso osse ro EL rr Ee E ON E P EDKeEE ER EI NU VP E Ve E ER Re UU EN E TES ETE 33 g t host Dalalms ies Seege eoo x ke Neo EF Ee EE Eee DAN e 34 DSU INSU sawn 35 set linkihfO WEE 35 get logi Params WWDHh ssexssssauerersuseiQexzira PX Ra wa PRRU NF RP Da v Raw rU Ras ER EEQR AT pag 35 set DUR EENEG Ae D ENN rna dE ENER ed e ee 36 get path eIndexs EE 36 IMPR ARRESTED 37 get port attrs index wwn all eessesesessseeeeee e hene 37 SOLEMN WWDN ssaeseessca aside Sere EReEP ERE TINTE MM WEanEOPEDIa E INI Dd RTESVEIEUS 39 get state lt WWDN gt See EN ENN SEENEN SEN EEN NEEN NENNEN ENNEN SEN SEENEN cease NEEN A0 get sym BR ln Eu EEN 40 get sym Dan peres eere pte s VPE E ENNER RAN Eed Ee ES 40 Ee lee A0 get topology 41 get dore eT PT 41 Mee 41 hte PT 42 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2c EMULEX Table of Contents 5 lirnik stat s d 1d i4 tetas e eU e t se e Vet ese i eve ae OR es 43 msgbuf all number i interval cesses 43 MS ee EE 44 wm bes deveene 45 ESAE sais es ee 45 PENES ies slo cic it EET ETIN NUR Mme TTE 45 parm get 15E EE 46 parm set label value
13. FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A Command Descriptions for emlxadm 2G EMULEX 3 Using the emlxadm Utility 37 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 Speed 1Gb Port Max Frame Size 0x800 bytes Fabric Name 0000000000000000 Number of Discovered Ports 4 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694
14. NIC Driver Configuration Table Heading Descriptions Continued 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 54 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 required command arguments For example emlxdrv
15. 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 lt cmd gt cmd_option s Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX Arguments N SFS FCT all Y cmd cmd option s 3 Using the emlxadm Utility 22 CLI Mode of Operation for emlxadm Indicates a specific emlxs driver instance For example N 1 means emlxs1 N 2 means emlxs2 and N 2 1 means emlxs2 1 Indicates all emlxs driver instances that are attached to the Oracle SFS interface Indicates all emlxs driver instances that are attached to the Oracle COMSTAR interface Indicates all emlxs driver instances 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 An emlxadm command See Table 3 1 Summary for emlxadm Commands on page 23 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 Runs utility in intera
16. SUNW emlxs 2 fp 0 0 devetl gt Do you wish to continue with this device y n q y Hu Vg After the user types y the emlxadm utility runs the command and displays the result 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 the command immediately 4 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 pciG81e 600000 SUNW emlxsQ2 fpQ0 0 devctl 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 part 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 emlxs 2 and the command get num devs Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility
17. 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 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility 20 Ces EMULEX CLI Mode of Operation for emlxadm 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 eml1xsQ2 fp80 0 devct1 the command get state and its lt wwpn gt argument 21000020371938fa 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
18. 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 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 28 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 parameter is a 4 byte hexadecimal pattern to be used for the test for example 0xXA5A5A5A95 Performs the power on self tests Performs the bus interface unit test emlxadm Result
19. elxnic5 Executes command on all oce driver instances If a full device path is not specified then the command will be executed on all device paths containing the specified device path string 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 boot code enable disable Description Page Sets or shows the boot code state of the current adapter 27 dev login lt wwpn gt Performs an FC login to an FC device on the network if not 27 already logged in dev logout lt wwpn gt Performs an FC logout to an FC device on the network if 27 not already logged out dev remove lt wwpn gt management Solaris FCA Utilities Version 2 90 10 0 User Manual Caution This command is not supported in the Solaris SFS stack and causes the host operating system to panic Removes the specified FC device from Solaris SFS 27 P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 24 Command Descriptions for emlxadm Table 3 1 Summary for emlxadm
20. gt lt EMULEX Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A Emulex Connects Servers Storage and People 2G EMULEX Copyright 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
21. 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 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc elxfc emlxs emlxs emlxs emxls elxfc elxfc fa00 fd00 fe00 yes fel2 100 111 fT12 fe05 f0a5 fc00 fc10 fc20 c40 704 714 yes yes NIC Driver Alias oce elxnic Command Descriptions for emlxdrv 700 710 4 Using the emlxdrv Utility 56 Command Descriptions for emlxdrv yes yes y LP10000 LP10000DC LP10000ExDC B B yes yes y LP11000 LP11002 yes yes y LPe11000 LPe11002 LPe11004 yes yes y LPel11000 LPel11002 LPe11004 B yes yes y Pe12000 LPel2002 yes yes y Pe12000 LPe12002 yes yes y LPel12000 LPe12002 e yes yes y LP21000 LP21002 yes yes 2G Blade Adapter yes yes
22. 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 2 90 10 0 User Manual P009694 01A Rev A Command Descriptions for emlxadm 2G EMULEX 3 Using the emlxadm Utility 54 set throttle Temporarily sets the I O queue depth for a specified remote port s The depth is the maximum number of concurrent I Os that the drive
23. the specified device s This command 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 set emlxs all Updating lpfs Updating f800 Updating 900 Cannot unload module lpfc Will be unloaded upon reboot Updating 980 Cannot unload module lpfc Will be unloaded upon reboot Updating fa00 Updating fd00 Updating fe00 Updating fc00 Updating fcl0 Updating fc20 Done 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 54 Note that each alias is shared by multiple adapter models Driver bindings Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 4 Using the emlxdrv Utility 63 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 emlxdr
24. 00 00 30 00 00 00 00 Done Solaris FCA Utilities Version 2 90 10 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 ssec sk Ras 00 00 00 00 08 00 00 00 2 49 yes P009694 01A Rev A Command Descriptions for emlxadm 2G EMULEX 3 Using the emlxadm Utility 40 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 get throttle WWPN Depth 21000011c6810947 512 21000011c681065f 512 21000011c68108c0 512 21000011c681061d 512 Solaris FCA Utilities Version 2 90 10 0 User
25. 4 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 49 Command Descriptions for emlxadm default 1 dynamic yes 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 O0 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 kk the kernel drv emlx conf file s and reboot the system Exits quits the utility program Example emlxadm q Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 50 Command Descriptions for emlxadm Exiting reset hard Forces the adapter to perform a hardware reset Example emlxadm reset hard Done reset link wwpn or 0 If the wwpn parameter is
26. 58 Command Descriptions for emlxdrv 2G EMULEX 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 8 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 Done Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 4 Using the emlxdrv Utility 59 2c EMULEX Command Descriptions for emlxdrv 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 54 to its associated devices Each alias is shared by multiple adapter models Example emlxdrv clear dev fe00 Updating fe00 Cannot unload module e
27. 9694 01A Rev A 2 Installing and Removing Utilities 13 2G EMULEX Removing the Utilities for Solaris 10 5 Reboot the system reboot Removing the Utilities for Solaris 10 There are three options for removing the emlxu utilities package 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 in the following section 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 Ifyouare 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 t
28. Commands Continued Command Syntax Description Page diag Performs a diagnostic test on the adapter Two formats are 27 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 28 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 28 download fcode filename Downloads the specified FCode image file to the adapter 29 download fw filename Downloads the specified firmware image file to the adapter 29 force dump Forces a firmware core dump on the adapter 30 get boot rev Returns the current boot revision of the adapter 30 get dev list Returns a list of FC devices currently seen by this adapter 30 port get dump h Saves the firmware core dump to a file 32 get dump size Returns the adapter s firmware core dump size 32 get fcode rev Returns the current FCode revision of the adapter 32 get fw rev Returns the current firmware revision of the adapter 32 get hba attrs Returns the current control attributes for the adapter 32 get host attrs Displays all of the current host adapter API attributes 33 ge
29. DR CLASS FC4_ TYPES TYPE PID WWPN PORT NAME WWNN NODE NAME IPA IP ADDR CLASS FC4_ TYPES Solaris FCA Utilities Versi 0 0 0 0 Class3 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Lport 0113E4 21000020371938a3 SEAGATE ST39103FC 0004 20000020371938a3 null fffffttttftftftttf 0 0 0 0 Class3 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 on 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 45 Command Descriptions for emlxadm TYPE PID WWP PORT NAME WWNN NODE NAME IPA IP ADDR CLASS FC4_ TYPES a Lport 0113E8 2100002037193670 SEAGATE ST39103FC 0004 2000002037193670 null Iffffffftfffffrtff 0 0 0 0 Class3 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Repeats the last command Example emlxadm get num devs Ther 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 gt label min current max default dynamic parm get adisc support adisc support 0 1 2 1 yes Solaris FCA Utilities V
30. E E VERRE KR ERE ESENE PET E REUS 12 Scripted lnstallatiOn RR 12 Manual installation 2 5 cerro epo err Ee Veo Re e AER ENNEN e AEN AN 12 Removing the Utilities for Solaris 10 eeeeeeeeeee eee eee eene hehehe 13 Removing the Utilities Using the emlxu remove Script essence ee eeeees 13 Removing the Utilities Man ally iicir eee ri dr nae prp geed EEN DEENEN 14 Removing the Utilities for Solaris 11 ceeeeeeeee eee eene eene eher eehnnnnn 14 Manual Removal ioco Dro devi veio eue au rutiner OU pOPICH Pueadesaa T Cz daveri ee aE 14 Scripted Removal vx uis deeem deest Ped od aire E EE Ee du ud Md aud duds 14 Updating the Utilities 5 5 deret NNN ENKE ENKER NENNEN EEN EEN a aea ao e se e o Vases 14 For Solaris EE 14 For Solaris KEE 15 3 Using the emlxadm Utility sccccicscccsscsdvcedccscvacscccaneasseesaedsececsssevuasseecevaes 16 Interactive Mode of Operation for emlxadm eeeeeee eee ee eee eene 16 Displaying Available Emulex Adapters eeeeeeeeeeeee eee nennen 16 Selecting an Adapter Port Attached to an SFS or FCT Stack eesses 17 Selecting an Adapter Port Attached to a NIC Strack 18 Entering emlxadm Commands uiid Sek e a uq rr ERR EXER E YF RA XAR E EEN AEN 18 Exiting emlxaditi eeu r ee rtp her rA E ER E ESSE EN SR SEEN RENNES ENEE 19 CLI Mode of Operation for emlxadm
31. EBUG 800 ELS sent GA NXT did fffffc 000113e1 00000000 55130 02 1002036 4 00C9 emlxs0 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 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 44 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 Nameserve TYPE PID WWPN PORT_NAME WWNN NODE NAME IPA IP ADDR CLASS FC4_ TYPES TYPE PID WWPN PORT NAME WWNN NODE NAME Er Lport 0113E1 21000020371938fa SEAGATE ST39103FC 0004 20000020371938fa null ffffffftffffftff 0 0 0 0 Class3 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Lport 0113E2 21000020371939a2 SEAGATE ST39103FC 0004 20000020371939a2 null IPA ffffffffffffffff IP AD
32. 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 900 yes yes yes P9002 LP9002C P9002DC LP9402DC 980 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 111 yes yes yes LPe12000 LPe12002 f112 yes yes yes Pe12000 LPel2002 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 LPel1000 S LPe11002 S fc40 e yes yes LPe12000 S LPe12002 S 704 E yes yes OCe10101 OCe10102
33. 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 Thesimultaneous use of the Ipfc driver and the emlxs or the elxfc driver 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 in order for the new configuration to 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 2 90 10 0 User Manual P009694 01A Rev A 4 Using the emlxdrv Utility 53 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 bindings associations between the
34. Manual P009694 01A Rev A EW 3 Using the emlxadm Utility 44 DG EMULEX Command Descriptions for emlxadm get topology Returns the FC network topology of the adapter port Example emlxadm 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 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
35. Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 32 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 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX NCSI Version Extended Timeout Model 3 Using the emlxadm Utility Command Descriptions for emlxadm 0 OneConnect OCe10100 Description Serial Number IP Version Firmware Version BIOS Version REDBOOT Version Driver Version Flash Fi
36. 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 Note References to OCe11100 series products also apply to OCe11100R series products Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A Table of Contents 2G EMULEX Table of Contents Listof Tables Jew e 6 Oe e rv 7 e R4 m Sue 7 Supported Drivers 1 2 eer e aV eoe erre nee Ta EE ESETE sw HEEN RENE NEEN NEEN EN 7 Abbreviations m M E 7 2 Installing and Removing Utilities eeeeee eee eee eese eene nennen 9 Monbrull 9 Installing the Utilities Tor Solaris n erre ioo erae nola NEE RENGER 9 Installing the Utilities Using the emlxu install Script 9 Installing the Utilities Mantually 4 sgeggeke vaa eausa ae Pega Ra aaa ES ER EE VE E 11 Installing the Utilities for Solaris 11 ccce eee eee eee eene nnne 11 Remote Repository Installation cceesssssssssseeeeeee emen 12 POP Archive Installation is nuets ur oa eux R
37. branded devices for FC drivers clear nic oracle Clears bindings to all Oracle branded devices for NIC drivers clear driver name oracle Clears bindings to all Oracle branded devices for a specific driver Example emlxdrv clear oracle Updating fc00 Cannot unload module emlxs Will be unloaded upon reboot Updating fc10 Cannot unload module emlxs Will be unloaded upon reboot Updating fc20 Cannot unload module emlxs Will be unloaded upon reboot Done 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 NOTE If changes were made then a system reboot may be required Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX refresh 4 Using the emlxdrv Utility 61 Command Descriptions for emlxdrv Refreshes the host bindings and main display with the latest information Example emlxdrv refresh The following output is displayed FC Driver el el el xEC lxfc Exc zb dol Ixfc Ixfc Lxfe LEG LC Ixfc Ixfc ZEC SEC emlxs emlxs emlxs emxls elxfc elxfc NIC Driver oce elxnic Alias Pres Boot Oracle emlxs elxfc lpfc Models Available Commands SOU
38. c Emulex distributed FC FCoE Solaris driver does not support Oracle branded devices 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 oce Solaris inbox NIC driver elxnic Emulex distributed Solaris NIC driver Abbreviations API application programming interface CLI Command line interface COMSTAR Common Multiprotocol SCSI Target D ID destination identifier BLS Extended Link Service FC Fibre Channel FCA Fibre Channel adapter FCIO FC input output FCoE Fibre Channel over Ethernet FCP Fibre Channel Protocol FCT Fibre Channel port provider module in Oracle COMSTAR stack FCTL Fibre Channel transport library Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 7 2G EMULEX HBA iSCSI LINIT man NIC PHY RNID SAN SFS SPARC UCNA VPD WWPN Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 1 Introduction Abbreviations host bus adapter internet Small 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 I
39. ctive mode or emlxadm v or emlxadm i lt N SFS FCT or all gt y lt cmd gt cmd_option s emlxadm j N SFS FCT or all gt y cmd cmd option s or emlxadm n N or all gt y cmd cmd option s or emlxadm m N or all y cmd cmd option s or emlxadm device path y cmd cmd option s OPTIONS V Display utility version information i N Executes command on a specific emlxs driver instance Example N 2 for emlxs2 or N 2 1 for emlxs2 1 iSFS Executes command on all SFS emlxs driver instances iFCT Executes command on all FCT emlxs driver instances iall Executes command on all emlxs driver instances Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX j N jsFS jFCT jall n N nall m N mall device path Executes command Executes command Executes command Executes command instance Example on on on on instance Example instance Example 3 Using the emlxadm Utility 23 Command Descriptions for emlxadm Executes command on 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 Executes command on all oce driver instances Executes command on a specific elxnic driver N 2 for elxnic2 or N 5 for
40. d Descriptions for emlxadm link status d id 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 O0xc Loss of signal count 0 0x0 Primitive sequence errors 0 0x0 Invalid tx words 17 0x11 Invalid CRC count 0 0x0 msgbuf all lt number gt 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 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 D
41. dapter 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 3 Using the emlxadm Utility 47 Command Descriptions for emlxadm Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility 48 2G EMULEX Command Descriptions for emlxadm 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 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 Solaris FCA Utilities Version 2 90 10 0 User Manual P00969
42. dm 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 2 90 10 0 User Manual P009694 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 341 Command Descriptions for emlxadm 0x00000000 0x00000000 0x00000000 0x00000000 Device 2 Dtype FC4 type proto State D id LILP Hard Addr WWPN 0x00000100 0x00000000 Logged In 113e4 0 e4 21000020371938a3 20000020371938a3 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 Device 3 Dtype FCA 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 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
43. e Sets the value of a specified parameter in the driver Only 49 dynamic parameters can be set q Exits quits the utility program 49 reset hard Forces the adapter to perform a hardware reset 50 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 26 Command Descriptions for emlxadm Table 3 1 Summary for emlxadm Commands Continued Command Syntax reset link lt wwpn or 0 Description If the wwpn parameter is specified this command resets the link of the specified FC device on the network If 0 zero is specified this command resets the local link Page 50 set sym nname string Sets the symbolic FC node name of the adapter to the string provided Note This operation is not supported by the Solaris SFS stack 50 set sym pname string Sets the symbolic FC port name of the adapter to the string provided Note This operation is not supported by the Solaris SFS stack 50 set throttle Solaris FCA Utilities Version 2 90 10 0 User Manual Temporarily sets the 1 O queue depth for a specified remote port 51 P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 27 Command Descriptions for emlxadm boot code enable disable Shows or sets the boot code state of the current adapter Examples To show the current boot code emlxadm boot code Boot code Disabled To enable the
44. eed 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 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 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility 36 gt lt 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 f 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 33 The index argument is an index into this list Example emlxadm get path 0 Adapter pci le 600000 SUNW emlxs 2 fp 0 0 emlxadm get path 1 Adapter pciQ81e 600000 SUNW emlxsQ2 1 fpQ0 0 Solaris
45. emu lex eee erret nnn th NN SEN RER NN ER REN ERR n nan nnn nni 63 Set driver name oracle erret ree tan en orar ssadaseasinn Rh RR Rien a RR E ct KD EE EN 63 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX List of Tables 6 List of Tables Table 3 1 Summary for embxadm Commands oen teres eae e ay ne kr e yg aa EP EE EF Run 23 Table 4 1 FC Driver Configuration Table Heading Descriptions Leeuuueue 54 Table 4 2 NIC Driver Configuration Table Heading Descriptions Luueueu 54 Table 4 3 Summary of emlxdry Commiands eege eh ko cave Eau Ran E E SEN dE ERAN SNE 57 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A gt lt EMULEX Overview 1 Introduction 1 Introduction Overview This Solaris Fibre Channel Adapter FCA Utilities User Manual provides information for the Emulex emlxadm and emlxdrv utility programs emlxadm changes driver parameters through a local interactive or command line interface CLI mode It can also update firmware on non Oracle branded devices emlxdrv binds associates various Fibre Channel FC and network interface card NIC drivers to various FC and NIC adapter models respectively Supported Drivers Emulex emlxadm and emlxdrv utility programs support the following FC and NIC drivers emlxs Solaris inbox Fibre Channel Fibre Channel over Ethernet FC FCoE driver elxf
46. ersion 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX desc 3 Using the emlxadm Utility 46 Command Descriptions for emlxadm Sets the Fibre Channel ADISC login support level parm get list Returns a list of configurable parameters Example emlxadm parm get list Parameter min current max default dynamic desc max default dynamic desc min current max default dynamic desc max default dynamic desc min current max default console notices 0x0 0x0 Oxffffffff 0x0 yes Verbose mask for notice messages to the console 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 fil log warnings 0x0 Oxffffffff Oxffffffff Oxffffffff Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX dynamic yes desc Verbose mask for warning messages to the messages fil 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 current 1024 max 10240 default 1024 dynamic no desc Number of outstanding IOCBs driver can queue to a
47. eturns 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 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 revl 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 firmware 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
48. forms 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 parameter in the driver Returns the driver s internal message log Returns the host adapter and port attributes all Returns the adapter path Returns the port attributes Returns the adapter s Vital Product Data VPD Sets or shows the boot code state in this HBA Gets the RNID information for local or specified port P009694 01A Rev A 3 Using the emlxadm Utility 18 2G EMULEX Interactive Mode of Operation for emlxadm get inst Gets the driver instance get phy attrs R
49. hat 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 pci80 0 pcil0de 5d8c pcil0df e60200 2 fp80 0 CONNECTED 2 NIC oce0 devices pci 0 0 pcildde 5d c pcilddf e602 0 CONNECTED 3 SFS emlxsl devices pci 0 0 pcildde 5d c pcil0df e602 0 3 fpe0 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 100 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 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 17 Interactive Mode of Operation for emlxadm After the available adapter list is displayed you are prompted to choose one of the available adapter ports by entering its list number or you can type 0 or zero to exit 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
50. his 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 2 90 10 0 User Manual P009694 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 administration documentation and the pkgadd 1M and pkgrm 1M man pages Removing the Utilities Manually To manually remove the EMLXemlxu utilities package 1 Loginas 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 ow Enter y The following message is displayed Remova
51. 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 all get_host_attrs msgbuf lt number gt get_port_attrs lt index gt get_path lt index gt get_vpd boot_code enable get_rnid wwpn disable devices pci 0 0 pcil0de 5d c pcil0df e602 0 2 fp 0 0 FCIO rev2 i interval lt wwn gt Solaris FCA Utilities Version 2 90 10 0 User Manual 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 Per
52. ion of lt EMLXemlxu gt y n UN 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 lt EMLXemlxu gt was successful The emlxu utilities installation is complete The utility package s programs are located in the opt EMLXemlxu bin directory You do not have to reboot the system to run a utility program but you must either enter the program s full path name or add the package s bin directory opt EMLXemlxu bin to the system environment s search path To use the man pages provided by the package you must also add the package s man directory opt EMLXemlxu man to the system environment s man path 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 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 2 90 10 0 User Manual P009694 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 L
53. l 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 index wwn 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 CONNECTED Enter an HBA number or zero to exit Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility 43 gt G EMULEX Comman
54. l 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 There are two options for updating the utilities package 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 package as detailed in Removing the Utilities Manually on page 14 Then manually Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 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 There are two options for updating the utilities package e Using the remote repository method run pkg update emlxu e Using the p5p installation method follow either the script or the manual procedure in
55. 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 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility 42 Command Descriptions for emlxadm 2G EMULEX 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 parameters 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 va
56. mlxs 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 gt 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 Cannot unload module emlxs Will be unloaded upon reboot Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A EW S 4 Using the emlxdrv Utility 60 Ces EMULEX Command Descriptions for emlxdrv Done clear driver oracle 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 Clears bindings to all Oracle branded devices for all drivers clear fc oracle Clears bindings to all Oracle
57. n 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 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 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 3 Using the emlxadm Utility 35 Command Descriptions for emlxadm 2G EMULEX get inst Returns driver instance for this adapter port Example emlxadm get inst emlxsO get linkinfo Returns the current link status information for the adapter port Example emlxadm get linkinfo Physical port 0 MAC Duplex Full Duplex MAC Sp
58. nstalling 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 There are two options for installing the emlxu utilities package e Using the emlxu install script see Installing the Utilities Using the emlxu install Script in the following section 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 late
59. og 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 For example pkg list af emlxu NAME PUBLISHER VERSION IFO emlxu emulex 1 8 4 0 0 emlxu emulex 1 9 39 0 0 lt 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 3 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 Installation Scripted Installation 1 2 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 2 90 10 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 P00
60. ow 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 54 Pres See the Pres description in Table 4 1 on page 54 Oracle See the Oracle description in Table 4 1 on page 54 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 4 Using the emlxdrv Utility 55 DG EMULEX CLI Mode of Operation for emlxdrv Table 4 2
61. q Exits quits the emlxdrv utility 60 refresh Refreshes the host bindings and main display with the latest information 61 set Sets the specific driver emlxs elxfc lpfc elxnic or oce to bind to the specified 62 device s The set command has several options e set driver name all sets the driver name to bind to all devices 62 e set driver name dev alias sets the driver name to bind to the devices 62 specified by a valid adapter alias e Set driver name emulex sets the driver name to bind to all 63 Emulex branded devices e set driver name oracle sets the driver name to bind to all 63 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 clear driver all Clears the bindings from the specified driver to all devices The valid driver values are fc nic and driver name as defined in the following section Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 4 Using the emlxdrv Utility
62. r 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 Loginas 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 2 90 10 0 User Manual P009694 01A Rev A 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 earlier 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 ta
63. r 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 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 4 Using the emlxdrv Utility 52 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 model is associated to only one of the
64. r 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 y n5 2 3 n n 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 Cleaning directory emlxu install complete Execute emlxu remove when ready to uninstall The script copies the emlxu remove script into the working directory with 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 sys
65. rmware 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 20 I OL 637 402 A2 rue Operational True 8342 8342 000000 0xC000 LIST MODE 0 0x19a2 0x0700 Oxl10df 0xe602 0 0 0 0 0 8 Displays all of the current host adapter API attributes Example emlxadm get host attrs Host Attributes Manufacturer Serial Number Model Oracle Microsystems BG43918495 LP10000DC S Solaris FCA Utilities Version 2 90 10 0 User Manual Inc P009694 01A Rev A 33 2G EMULEX 3 Using the emlxadm Utility 34 Command Descriptions for emlxadm 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 11f t3 2006 04 25 11 43 Optional ROM Version 1 50a9testl Firmware Versio
66. t host params Returns the FC login parameters of this adapter port 34 get inst Returns driver instance for this adapter port 35 get linkinfo Returns the current link status information for the adapter 35 port get logi params lt wwpn gt Returns the FC login common service parameters for a 35 specified FC device on the network get num devs Returns the number of FC devices currently seen by this 29 adapter port get path index Shows the current Solaris device path for a specified 36 Solaris FCA Utilities Version 2 90 10 0 User Manual 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 P009694 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 get phy attrs Shows the current PHY module attributes of the adapter 37 Note This command applies to UCNAs only get port attrs index Shows the current adapter API port attributes All of the 37 lt wwn gt all ports attributes can be displayed or a single port can be specified by index or wwn 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 arg
67. tem 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 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 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 manually 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 installat
68. 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 Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A 2G EMULEX 3 Using the emlxadm Utility 49 CLI Mode of Operation for emlxadm 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 The emlxadm utility can now run the command and display the state State PORT DEVICE LOGGED IN Exiting emlxadm aw To exit quit the emlxadm utility type q at the prompt emlxadm q CLI Mode of Operation for emlxadm There 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
69. ument is an index into this list get rnid wwpn Returns the RNID information for the local or specified port 39 get state lt wwpn gt Returns the current Solaris SFS state of the specified FC 40 device on the network get sym nname Returns the symbolic FC node name of the adapter port 40 Note This operation is not supported by the Solaris SFS stack get sym pname Returns the symbolic FC port name of the adapter port 40 Note This operation is not supported by the Solaris SFS stack get throttle Returns the I O queue depth of all remote ports 40 get topology Returns the FC network topology of the adapter port 41 get vpd Shows the current adapter s vital product data 41 h Returns the help screen that is it lists the available 41 commands hba Allows you to select another adapter with which to 42 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 43 FC device specified by the D ID address msgbuf all number This command displays the current driver log with various 43 i interval options ns Performs and returns a complete query of the fabric name 44 server p Repeats the last command 45 parm get label Retrieves the value of a specified parameter in the driver 45 parm get list Returns a list of configurable parameters 46 parm get num Returns the total number of configurable parameters 45 parm set label valu
70. v gt set emlxs 980 Updating 980 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 fc10 Updating fc20 Done Solaris FCA Utilities Version 2 90 10 0 User Manual P009694 01A Rev A

Solaris FCA Utilities Version 2.90.10.0 User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents