Home

Solaris FCA Utilities Version 1.08.2 User Manual

1. To make this change you must edit the kernel drv emlxs conf or kk zx the kernel drv emlx conf file s and reboot the system Exits quits the utility program Example emlxadm gt q Exiting Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 47 gt EMULEX Command Descriptions for emlxadm reset_hard Forces the adapter to perform a hardware reset Example emlxadm gt reset_hard Done reset_link lt wwpn or 0 gt If the wwpn parameter is specified this command resets the link of the specified FC device on the network If the specified wwpn applies to a remote port the reset link wwpn only works if the remote port is on a public loop SFS uses the Loop Initialize LINIT 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 gt reset_link 21000020371938fa Done Resets the local link emlxadm gt 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 gt set_sym_nname Emulex Corporation ioctl FCIO_SET_SYM_NNAME Operation not supported set_sym_pname lt string gt Se
2. Clears driver bindings to specified devices refresh Refresh driver bindings to current devices gq Exits this program set This command sets the bindings from the specified driver emlxs elxfc lpfc elxnic or oce to 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 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt EMULEX set driver_name all 4 Using the emlxdrv Utility 59 Command Descriptions for emlxdrv Sets the specified driver_name to bind to all devices The valid driver_name values are emlxs elxfc lpfc elxnic or oce Example emlxdrv gt Updating Updating Updating Cannot unload module Will be unloaded upon set emlxs all lpfs f800 f900 Updating 980 Cannot unload module Will be unloaded upon U U set driver_name alias pda pda pda pda pda pda ting ting ting ting ting ting Done fa00 d00 fe00 c00 fcl10 f c20 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
3. Alias description in Table 4 1 on page 51 Pres See the Pres description in Table 4 1 on page 51 Oracle See the Oracle description in Table 4 1 on page 51 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 51 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 4 Using the emlxdrv Utility 52 CLI Mode of Operation for emlxdrv gt EMULEX 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 gt refresh The current driver configuration table and the available command list are displayed automatically after each command is issued Some commands require a lt driver gt or lt driver_name gt and an lt alias gt argument You must specify one of the valid adapter aliases listed in the current driver configuration table Each alias is shared by multiple adapter models Driver bindings can be made only with an adapter alias and not with a specific adapter model Exiting emlxdrv To ex
4. desc A count of milliseconds after which an interrupt response is generated label cr count min 1 current 1 max 255 default 1 dynamic no desc A count of I O completions after which an interrupt response is generated label assign alpa min 0x0 current 0x0 max Oxef default 0x0 dynamic no desc Assigns a preferred ALPA to the port Only used in Loop topology label adisc support min 0 current 1 max 2 default 1 dynamic yes Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A Se EMULEX 3 Using the emixadm Utility 46 Command Descriptions for emlxadm desc Sets the Fibre Channel ADISC login support level label pm support min 0 current 1 max 1 default 1 dynamic no desc Enables power management support parm_set lt label gt lt value gt 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 gt parm_set adisc support 2 label adisc support min 0 current 2 max 2 default 1 dynamic yes desc Sets the Fibre Channel ADISC login support level This example attempts to set a static parameter which is not allowed emlxadm gt parm_set network on 1 emlxadm EMLX_PARM SET Parameter network on is not dynamic and cannot be changed here
5. 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 SEAGATE ST39103FC 0004 Unknown Unknown 0x0 bytes 0000000000000000 2000002037193943 2100002037193943 0113e4 Unknown Unknown P008023 01A Rev A SG EMULEX Port Supported COS Port Supported FC4 Types Port Active FC4 Types Port Symbolic Name Port Supported Speed Port Speed Port Max Frame Size Port 3 get_ Fabric Name Node Port Port Port Port Port POTE Port Port Port Port Port Attributes WWN WWN Fe Id Type State Supported COS Supported FC4 Types Active FC4 Types Symbolic Name Supported Speed Speed Max Frame Size Fabric Name rnid wwpn Returns the Request Node Identification Data ELS RNID information for the local or CG lass3 3 Using the emlxadm Utility 36 Command Descriptions for emlxadm 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 S U U EAGATE ST39103FC 0004 nknown nknown 0x0 bytes 0000000000000000 2000002037193670 2100002037193670 0 U U C 0 0 S U U 113e8 nknown nknown lass3 0000000 00000000 00000000 00000000 0000000 00000000 00000000 00000000 00000000 0
6. Removing the Utilities Manually este e eee eter cease seas eeeaeeeeneteenaeeeas 13 Updating The Utiliti S srira nna a ai 13 3 Using the emlxadm Utility eieettee aere aa aaa a 14 Interactive Mode of Operation for emlxadmM ssssssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnn 14 Displaying Available Emulex Adapnters eect esses eeeneeeeneeeeneenenne nen 14 Selecting an Adapter Port Attached to an SFS or FCT Stack 15 Selecting an Adapter Port Attached to a NIC Stack 16 Entering emlxadm CommandsS ss cc a15 20 tinst avd andnnsea abn centeaerandanveceductanresweandeaned 16 Exiting emlxadmM EE 17 CLI Mode of Operation for emlxadm s sssssssssnsnnnnnnsnnnnnnnnnnnnnnnunnnnnnnnnnnnnnnnnn 17 Device Path Option it Cl RTE 17 Device Path Option for a Single Adapter 17 Device Path Option for Multiple Adapters sssssssssssssssessrerrerererrerrrrrrrrrrerrerrre 18 Instance Option re Re 19 Using emlxadm help for Command Usage in CLI Mode 20 Command Descriptions for emlxadmM sssssssssrsssssusnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 21 boot code enable disable eege suettindcencediaviasanadtanesaxaeineedaanedearaaeoeiades 24 CSV Ee 24 Gen lOGOUE SWINE eegebttAege EENS EES See ENEE 24 dev_reMOve lt i EE 24 diag RENE 24 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A DE EMULEX Table of Contents 4 diag code md_COde gt sssserrrrrsstttrrntttttirn ttun rr nrun ann tErrEARCEEENEA EEEE EEA EEEn 25
7. removes all emlxu files See Removing the Utilities Using the emlxu_remove Script on page 12 e Manually by using pkgrm removes all emlxu files See Removing the Utilities Manually on page 13 Removing the Utilities Using the emlxu_ remove Script To remove all emlxu files using the emlxu_remove script 1 Loginas root or su to root 2 Ifyou are in the directory of the emlxu_remove script go to step 4 Otherwise go to the directory where the original emlxu utilities package tar file is located cd lt directory gt 3 Extract the emlxu_remove script from the emlxu utilities package tar file tar xf emlxu_kit lt version gt sparc tar emlxu_remove 4 Run the emlxu_remove script emlxu_remove 5 The emlxu_remove script locates the EMLXemlxu package and the following message is displayed lt Removing EMLXemlxu package gt If an emlxu utilities package is not found a message is displayed indicating this and you can skip to step 7 Otherwise you are prompted to remove the package Do you want to remove this package y n q ow Enter y The following message is displayed Removal of lt EMLXemlxu gt was successful 6 The script performs some cleanup and the following messages are displayed lt Removing emlxu scripts gt lt emlxu_remove complete gt The utilities package has been removed 7 Ifyou want to install another version of the emlxu utilities package fo
8. 56 Oracle branded devices The valid driver values are fc nic and driver_name q Exits quits the emlxdrv utility 57 refresh Refreshes the host bindings and main display with the latest information 57 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt EMULEX 4 Using the emlxdrv Utility 54 Command Descriptions for emlxdrv Table 4 3 Summary of emlxdrv Commands Continued Command Description BEE 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 Page Sets the specific driver emlxs elxfc Ipfc elxnic or oce to bind to the specified 58 device s The set command has several options e set driver_name all sets the driver_name to bind to all devices 59 e set driver_name dev alias sets the driver_name to bind to the devices 59 specified by a valid adapter alias e set driver_name emulex sets the driver_name to bind to all 60 Emulex branded devices e set driver_name oracle sets the driver_name to bind to all 60 Oracle branded devices The valid driver_name values are emlxs elxfc Ipfc elxnic or oce 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 require
9. AAE IPEER ENEE eg Bee Res 42 parmeget dabel EE 42 parmi get TE 43 parm_set abel eet Ee tutturun unuu EAEE EEEE EEEEEEE EEEE EEEE EEEE 46 EE 46 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A Table of Contents gt EMULEX reset NON E 47 reset_link LWW Or Mate 47 Set EE EIDEL SUING est 47 set_sym_pname lt SEr Ng eege base EEN Eege dE Ree E ge 47 seti throttle iroa hese eben A EEEE ENEE EERE ENEE n 48 4 Using the emlxdrv Utility ssssssnssnnnnnssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne 49 Interactive Mode of Operation for emlvdrv ee NEEN EEN ER NEE NEE NEE NEE EE 49 Displaying Bindings Between Drivers and Adapter Models eee ees 49 Entering emlxdryv ee un EE 52 Exiting eM XAFV EE 52 CLI Mode of Operation for emlvdry sek NEE NEE REENEN REENEN NEE NEE NEEN 52 Command Descriptions for emlvdry ssssssssnsnnnnsnnsnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnunnnn 53 Clafi ge ge E AE 54 Clear driver all ciacsceiie cdeceaeeoias ei E Ee eeu tee 54 Clea dey alls EE 55 eidele Ee LE EE 56 clear driver OFAC EEN 56 eT ee ee ee ee es ee ee ee eee 57 BEE rE E E O a Ea 57 EE E E T numbed A E 58 set driver name all 59 set driver name alias 2 dis HEEN DEN SEN seetie EBEN EEN EEN ER ade nana ENEE 59 set driver name emulen 1 0 nny 60 Set driver name orales rieren geed 60 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 5 gt G EMULEX List of Tables 6 List
10. Alias column in Table 4 1 on page 51 Note that each alias is shared by multiple adapter models Driver bindings can be made only with an adapter alias and not with a specific adapter model The valid driver_name values are emlxs elxfc lpfc elxnic or oce Example emlxdrv gt set emlxs 980 Updating 980 Cannot unload module Will be unloaded upon reboot Done Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A Command Descriptions for emlxdrv Sa EMULEX 4 Using the emlxdrv Utility 60 set driver_name emulex Sets the specific driver_name to bind to all Emulex branded devices The valid driver_name values are emlxs elxfc lpfc elxnic or oce Example emlxdrv gt 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 lpfc elxnic or oce Example emlxdrv gt set emlxs oracle Updating fc00 Updating fcl0 Updating fc20 Done Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A
11. and returns a complete query of the fabric name 41 server p Repeats the last command 42 parm_get lt label gt Retrieves the value of a specified parameter in the driver 42 parm get List Returns a list of configurable parameters 43 parm_get_num Returns the total number of configurable parameters 42 parm_set lt label gt lt value gt Sets the value of a specified parameter in the driver Only 46 dynamic parameters can be set q Exits quits the utility program 46 reset_hard Forces the adapter to perform a hardware reset 47 reset_link lt wwpn or 0 gt lf the wwpn parameter is specified this command resets 47 the link of the specified FC device on the network If 0 zero is specified this command resets the local link set_sym_nname lt string gt Sets the symbolic FC node name of the adapter to the string 47 provided Note This operation is not supported by the Solaris SFS stack set_sym_pname lt string gt Sets the symbolic FC port name of the adapter to the string 47 provided Note This operation is not supported by the Solaris SFS stack set_throttle Temporarily sets the I O queue depth for a specified 48 Solaris FCA Utilities Version 1 08 2 User Manual remote port P008023 01A Rev A Se EMULEX 3 Using the emixadm Utility 24 Command Descriptions for emlxadm boot_code enable disable Shows or sets the boot code state of the current adapter Examples To show the curre
12. bindings from the specified driver to all Oracle branded devices The valid driver values are fc nic and driver_name as defined in the following section Command Options clear oracle clear fc oracle clear nic oracle cl ear driver_name oracle Clears bindings to all Oracle branded devices for all drivers Clears bindings to all Oracle branded devices for FC drivers Clears bindings to all Oracle branded devices for NIC drivers Clears bindings to all Oracle branded devices for a specific driver Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 4 Using the emlxdrv Utility 57 Command Descriptions for emlxdrv gt EMULEX Example emlxdrv gt clear oracle Updating fc00 Cannot unload module emlxs Will be unloaded upon reboot Updating fcl0 Cannot unload module emlxs Will be unloaded upon reboot Updating fc20 Cannot unload module emlxs Will be unloaded upon reboot Done 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 gt q Exiting NOT ts If changes were made then a system reboot may be required refresh Refreshes the host bindings and main display with the latest information Example emlxdrv gt refresh The following output is displayed FC Driver Al
13. example milxadm Displaying Available Emulex Adapters After the emlxadm utility is started it scans the host system and prepares a list of qualified adapter ports Qualified adapter ports are devices that are attached to the emlxs elxfc oce or elxnic driver After each list number the display indicates the adapter s type of stack and type of driver For example Available Emulex HBA s 1 SFS emlxs0 devices pci 0 0 pcildde 5d c pcilddf e602 0 2 fp 0 0 CONNECTED 2 NIC oce0 devices pci 0 0 pcildde 5d c pcilddf e602 0 CONNECTED 3 SFS emlxsl devices pci 0 0 pcildde 5d c pcil0df e602 0 3 fp 0 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 10080 CONNECTED 6 SFS emlxs3 devices pci 0 0 pcildde 5d d pcil0ddf 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 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 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 15 Interactive Mode of Operation
14. for emlxadm gt EMULEX Selecting an Adapter Port Attached to an SFS or FCT Stack If you select an adapter port that is attached to an SFS or FCT stack the emlxadm utility displays a list of available commands For example if you enter 1 from the example in Displaying Available Emulex Adapters on page 14 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 lt string gt get_sym_nname set_sym_nname lt string gt dev_login lt wwpn gt dev_logout lt wwpn gt get_state lt wwpn gt dev_remove lt wwpn gt link_status lt d_id gt get_fcode_rev download_fcode filename get_fw_rev download_fw filename get_boot_rev 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 lt label gt parm_set lt label gt lt val gt all get_host_attrs msgbuf lt number gt get_port_attrs lt index gt lt wwn gt all get_path lt index gt get_vpd boot_code enable get_rnid wwpn get_inst get_phy_attrs set throttle get_throttle Solaris FCA Utilities Version 1 08 2 User Manual disable devices pci 0 0 pcildde 5d c pcil0df e602 0 2 fp 0 0 FCIO rev2 i interval Returns the number of FC devices seen by this HBA Returns a list of FC devices seen by this HBA Returns the logi
15. gt G EMULEX Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A Emulex Connects Servers Storage and People gt EMULEX Copyright 2002 2012 Emulex All rights reserved worldwide No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of Emulex Information furnished by Emulex is believed to be accurate and reliable However no responsibility is assumed by Emulex for its use or for any infringements of patents or other rights of third parties which may result from its use No license is granted by implication or otherwise under any patent copyright or related rights of Emulex Emulex the Emulex logo AutoPilot Installer AutoPilot Manager BlockGuard Connectivity Continuum Convergenomics Emulex Connect Emulex Secure EZPilot FibreSpy HBAnyware InSpeed LightPulse MultiPulse OneCommand OneConnect One Network One Company SBOD SLI and VEngine are trademarks of Emulex All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations Emulex provides this manual as is without any warranty of any kind either expressed or implied including but not limited to the implied warranties of merchantability or fitness for a particular purpose Emulex may make improvements and changes to the product described in this manual at any time and without any notice Emulex as
16. of Tables Table 3 1 Summary for emlxadm eur EE 21 Table 4 1 FC Driver Configuration Table Heading Descriptions ccccccccccccccccrcccc 51 Table 4 2 NIC Driver Configuration Table Heading Descriptions ccccccccccccccccrcc 51 Table 4 3 Summary of emlxdrv KOENEN EEN EE SEENEN 53 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A XC EMULEX 1 Introduction 7 Overview 1 Introduction Overview This Solaris Fibre Channel Adapter FCA Utilities User Manual provides information for the Emulex emlxadm and emlxdrv utility programs e emlxadm changes driver parameters through a local interactive or command line interface CLI mode It can also update firmware on non Oracle branded devices e emlxdrv binds associates various Fibre Channel FC and network interface card NIC drivers to various FC and NIC adapter models respectively Audience For system administrators this document includes information about installing and removing these utilities System administrators should be familiar with Solaris and the Oracle StorEdge SAN Foundation Software SFS and should have access to standard system documentation Anyone working with this product should be familiar with the Emulex OneConnect universal converged networking adapter UCNA as well as FC and Ethernet technologies Supported Drivers Emulex emlxadm and emlxdrv utility programs support the following FC and NIC drivers e emlxs Solaris inbox Fib
17. point the utility is prompt driven When the prompt is displayed you can enter one of the commands in the list For example you can display the list of available commands at anytime by typing h the help screen at the prompt emlxadm gt 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 gt get_state The emlxadm utility returns Usage get_state lt wwpn gt Therefore you must include the lt wwpn gt argument for the get_state command to receive a valid response for example emlxadm gt get_state 21000020371938fa The emlxadm utility can now run the command State PORT_DEVICE_LOGGED_IN Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A Se EMULEX 3 Using the emixadm Utility 17 CLI Mode of Operation for emlxadm Exiting emlxadm To exit quit the emlxadm utility type q at the prompt emlxadm gt 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 19 Device Path Option in CLI Mode In this CLI mode option the user types emlxadm the device path fo
18. self tests Examples Performs the bus interface unit test emlxadm gt diag emlx_biu Result EMLX_DIAG BIU Operation successful Performs the echo test to a lt did gt fffffc emlxadm gt diag emlx_echo fffffc Result EMLX_DIAG_ ECHO Operation successful Performs the power on self tests emlxadm gt diag emlx_post Result EMLX_DIAG POST Operation successful diag code lt cmd_code gt 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 gt diag code 0x4526 Result CODE 0x4526 16 0x10 download_boot lt filename gt Downloads the specified boot image file to the adapter Example emlxadm gt download_boot TD190A4 PRG Image Components REL type size 143416 DWC file BOOT version 03845054 1 90a4 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 26 Command Descriptions for emlxadm gt 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 lt filen
19. the newer version e Manually first manually remove the existing EMLXemlxu utilities package as detailed in Removing the Utilities Manually on page 13 Then manually install the newer EMLXemlxu utilities package as detailed in Installing the Utilities Manually on page 11 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 14 Interactive Mode of Operation for emlxadm gt 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 FC input output FCIO interface provided by the Oracle StorEdge SFS The FCIO interface provides a Oracle common ioctl interface to the FC transport library FCTL driver which manages the FCA drivers for each Fibre Channel adapter attached to the host system The emlxadm utility program can run in two modes e Interactive mode see the following section e CLI mode see page 17 Note Note that 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
20. 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 allow you to change the driver binding to an adapter currently providing connectivity to the boot disk If the driver binding needs to be changed to a boot device the system must first be configured to boot through an adapter of another type This procedure is not in the scope of this document Oracle A yes indicates that this specific type of adapter is branded and sold directly by Oracle emlxs A yes indicates the emlxs driver supports this specific type of adapter elxfc A yes indicates the elxfc driver supports this specific type of adapter lpfc A yes indicates the Ipfc 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 NIC Driver Description The type of NIC driver oce or elxnic that is currently configured to bind or attach to a specific adapter alias Alias See the
21. which to interface This command allows you to connect to another adapter without having to exit and re enter the program Example emlxadm gt hba Available Emulex HBA s 1 SFS emlxs0 devices pci 7c0 pci 0 pci l pci 0 2 SUNW emlxs 1 fp 0 0 CONNECTED 2 FCT emlxsl devices pci 7c0 pci 0 pci l pci 0 2 SUNW emlxs 1 1 CONNECTED Enter an HBA number or zero to exit Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 40 gt EMULEX Command Descriptions for emlxadm link_ status lt d_id gt Requests and returns the current link error status from the FC device specified by the D_ID address Example emlxadm gt link status e8 D_ID e8 Link failures 3 0x3 Loss of sync count 12 0xc Loss of signal count 0 0x0 Primitive sequence errors 0 0x0 Invalid tx words 17 0x11 Invalid CRC count 0 0x0 msgbuf all 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 display
22. 000 LPe12002 elxfc fe05 yes yes yes LP21000 LP21002 elxfc f0a5 yes yes 2G Blade Adapter emlxs FcO0O yes yes LP10000 S LP10000DC S emlxs fcl10 yes yes yes LP11000 S LP11002 S emlxs EZ z yes yes LPe11000 S LPe11002 S emxls fc40 yes yes LPe12000 S LPe12002 S elxfc 704 yes yes OCe10101 OCe10102 elxfc 714 yes yes yes OCe11101 OCe11102 NIC Driver Alias Pres Oracle oce elxnic Models oce 700 8 yes yes OCe10101 OCel0102 elxnic 710 yes yes OCe11101 OCe11102 Command Descriptions for emlxdrv Note You can 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 49 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 54 clear command has several options e clear driver all clears bindings from the specified driver to all devices 54 e clear dev alias clears bindings from a valid adapter alias to its associated 55 devices e clear driver emulex clears bindings from the specified driver to all 56 Emulex branded devices e clear driver oracle clears bindings from the specified driver to all
23. 0000000 00000000 00000000 00000000 00000000 00000000 00000000 EAGAT E ST39103FC 0004 nknow nknow n n 0x0 bytes 0000000000000000 08 09 OA OB OC OD OE OF ASCII specified port Example emlxadm gt get_rnid Offset 00 01 02 03 04 05 06 07 0 31 30 30 30 30 30 30 30 10 00 00 00 07 00 00 00 00 20 00 00 00 00 00 00 00 00 30 00 00 00 00 Done Solaris FCA Utilities Version 1 08 2 User Manual 63 39 34 63 62 64 34 65 10000000c94cbd4e 00 00 00 00 00 DL 00500 ech A EE de as 00 00 00 00 OOOO O10 EI aa reo a aw taal eae P008023 01A Rev A Command Descriptions for emlxadm Se EMULEX 3 Using the emixadm Utility 37 get_state lt wwpn gt Returns the current Solaris SFS state of the specified FC device on the network Example emlxadm gt 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 gt 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 gt 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 concurren
24. 0000000 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 1 08 2 User Manual P008023 01A Rev A gt EMULEX Port 0 Attributes Node WWN Port WWN Port Fe 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 Fe Id Port Type Port State Port Supported COS 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 Fe Id Port Type Port State Solaris FCA Utilities Version 1 08 2 User Manual Port Supported FC4 Types 3 Using the emlxadm Utility 35 Command Descriptions for emlxadm 20000020371938FA 21000020371938FA 0113el Unknown Unknown Class3 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 SEAGATE ST39103FC 0004 Unknown Unknown 0x0 bytes 0000000000000000 2000002037193842 2100002037193842 0113e2 Unknown Unknown Class3
25. 4 devices reported on this port parm_get_num Returns the total number of configurable parameters Example emlxadm gt parm_get_num Result There are 18 configurable parameters in the driver parm_get lt label gt Gets the value of a specified parameter in the driver Example emlxadm gt parm_get adisc support label adisc support min 0 current I max 2 default 1 dynamic yes desc Sets the Fibre Channel ADISC login support level Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A we 3 Using the emlxadm Utility 43 Se EMULEX Command Descriptions for emlxadm parm_get_list Returns a list of configurable parameters Example emlxadm gt parm_get_list Parameter label console notices min 0x0 current 0x0 max Oxffffffft default 0x0 dynamic yes desc Verbose mask for notice messages to the console label console warnings min 0x0 current 0x0 max Oxffffffff default 0x0 dynamic yes desc Verbose mask for warning messages to the console label console errors min 0x0 current 0x0 max Oxffffffff default 0x0 dynamic yes desc Verbose mask for error messages to the console label log notices min 0x0 current Oxffffffff max Oxffffffft default Oxffffffff dynamic yes desc Verbose mask for notice messages to the messages file label log warnings min 0x0 current Oxffffffff max Oxffffffff default Oxffffffff dynamic yes
26. Executes command on a specific elxnic driver instance Example N 2 for elxnic2 or N 5 for elxnicS5 mall Executes command on all oce driver instances device_path If a full device path is not specified then th command will be executed on all device paths containing the specified device_path string Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt G EMULEX If multipl 3 Using the emlxadm Utility 21 Command Descriptions for emlxadm devices ar found the utility will ask for verification before executing the command on each device This option will cause the utility to skip the verification and automatically execute the command on each device Command Descriptions for emlxadm This section provides a list of commands and descriptions that can be issued with the emlxadm utility Table 3 1 summarizes this command list including abbreviated descriptions Table 3 1 Summary for emlxadm Commands Command Syntax Description Page boot_code enable Sets or shows the boot code state of the current adapter 24 disable dev_login lt wwpn gt Performs an FC login to an FC device on the network if not 24 already logged in dev_logout lt wwpn gt Performs an FC logout to an FC device on the network if 24 not already logged out dev_remove lt wwpn gt Removes the specified FC device from Solaris SFS 24 management Caution This command is n
27. Solaris FCA Utilities Version 1 08 2 User Manual 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 P008023 01A Rev A gt G EMULEX 3 Using the emlxadm Utility 29 Command Descriptions for emlxadm emlxadm gt 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 gt get_dump_size Size Result if a valid dump does not exist in the driver memory 6580624 0x646990 bytes emlxadm gt get_dump_size 0 0x0 bytes Size get_fcode_rev Returns the current FCode revision of the adapter Example emlxadm gt get_fcode_rev FCODE revision get_fw_rev LP10000 S 1 41a3 Returns the current firmware revision of the adapter Example emlxadm gt Firmware get_fw_rev revision LP10000DC S 1 90a3 get_hba_attrs Returns the current control attributes for the adapter Example emlxadm gt HBA Flas get_hba_attrs h ROM Version Manufacturer Support Modes EEPROM Version IOCTL Version EP Fw Version SE HBA ATTR VER 0000 0001 Emulex Corpora TOE NIC VM FCO 2 432 0x00012345 0x00897654 tion E INI LRO 0 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt G EMULEX NCSI Version Def Extended Timeout Model 3 Using the emlxadm Utility 30 Comm
28. The lt index gt argument is an index into this list get_rnid wwpn Returns the RNID information for the local or specified port 36 get_state lt wwpn gt Returns the current Solaris SFS state of the specified FC 37 device on the network get_sym_nname Returns the symbolic FC node name of the adapter port 37 Note This operation is not supported by the Solaris SFS stack get_sym_pname Returns the symbolic FC port name of the adapter port 37 Note This operation is not supported by the Solaris SFS stack get_throttle Returns the I O queue depth of all remote ports 37 get_topology Returns the FC network topology of the adapter port 38 get_vpd Shows the current adapter s vital product data VPD 38 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A SG EMULEX 3 Using the emlxadm Utility 23 Command Descriptions for emlxadm Table 3 1 Summary for emlxadm Commands Continued Command Syntax Description Page h Returns the help screen that is it lists the available 38 commands hba Allows you to select another adapter with which to 39 interface This prevents you from having to exit and reenter the program link_status lt d_id gt Requests and returns the current link error status from the 40 FC device specified by the D_ID address msgbuf all lt number gt This command displays the current driver log with various 40 i interval options ns Performs
29. ame gt Downloads the specified FCode image file to the adapter Example emlxadm gt download_fcode LP10000DC S fcode Image Components REL type size 33848 DWC file BOOT version 03841512 1 50a2 Current Fcode 1 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 lt filename gt 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 gt download_fw LP10000DC S fw Image Components NOP type AWC file KERN version ff801315 30a5 DWC file SLI2 version 07831914 90a4 DWC prog TEST version 00f51010 1 00a0 DWC prog STUB version 02881914 1 90a4 DWC prog SLI1 version 06831914 1 90a4 DWC prog SLI2 version 07831914 1 90a4 Current Firmware 1 90a4 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt G EMULEX New Firmware 1 05e 366712 0x59878 Are you sure you want to download this image Downloading Done force_dump Forces a firmware core dump on the adapter Example emlxadm gt force_dump Done get_boot_rev Returns the current boot revision of the adapter Example emlxadm gt get_boot_rev Firmware revision LP10000DC S 1 90a3 get_dev_list 3 Using the emlxadm Utility 27 Command Descriptions for eml
30. and Descriptions for emlxadm 0 OneConnect OCe10100 Description Serial Number IP Version Firmware Version BIOS Version REDBOOT Version Driver Version Flash Firmware Version Functions Supported Max CDB Length ASIC Revision Generational GUID HBA Port Count Multifunction Device iSCSI Version Def Linkdown Timout Physical Port Max Domains Supported HBA Status Cache Valid HBA MTU Firmware Post Status iSCSI Features PCI Vendor ID PCI Device ID PCI SubVendor ID PCI SubDevice ID PCI Bus Number PCI Device Number PCI Function Number Interface Type Unique Identifier Net Filters get_host_attrs BladeEngine 2 10Gb FCoE Initiator 0x425439343138323738310000000000000000000000000000 IPv4 2 701 374 2 2 101374 2 2 0 38 0 2 701 374 2 A2 rue Operational rue 8342 8342 00000 0 0xC000 LIST_MODE 0 Ox19a2 0x0700 0x10df 0xe602 o OO OO OO CO CH Displays all of the current host adapter API attributes Example emlxadm gt get_host_attrs Host Attributes Manufacturer Serial Number Model Solaris FCA Utilities Version 1 08 2 User Manual BG43918495 LP10000DC S Oracle Microsystems Inc P008023 01A Rev A gt G EMULEX Model Description Node WWN Node Symbolic Name Hardware Version Driver Version Optional ROM Version Firmware Version Vendor Specific ID Number of HBA ports Driver Name Last Change fp Instance N
31. ate in this HBA Gets the RNID information for local or specified port Gets the Returns the current PHY attributes for the HBA CNA s only driver instance Temporarily sets the I O queue depth for a specified remote port Gets the I O queue depth for all remote ports P008023 01A Rev A 3 Using the emlxadm Utility 16 gt lt EMULEX Interactive Mode of Operation for emlxadm q Exits this program h Returns this help screen hba Select another hba p Repeat previous command emlxadm gt 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 14 the emlxadm utility displays HBA 2 devices pci 0 0 pcil0dde 5d c pcil0df e602 0 physical port Available commands NIC rev1 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 gt Entering emlxadm Commands After the available commands are listed the emlxadm gt prompt is displayed From this
32. c F100 yes yes y elxfc 111 yes yes y elxfc F112 yes yes y elxfc fe05 yes yes y elxfc f0a5 yes yes emlxs FcO0O yes yes emlxs fcl10 yes yes yes emlxs G20 yes yes emxls fc40 yes yes elxfc 704 yes yes elxfc 714 yes yes yes NIC Driver Alias Pres Oracle oce oce 700 yes yes elxnic 710 2 yes yes Available Commands set Sets driver bindings to specified devices clear Clears driver bindings to specified devices refresh Refresh driver bindings to current devices q Exits this program emlxdrv gt Solaris FCA Utilities Version 1 08 2 User Manual S LPe12002 S OCe10102 OCe11102 OCe10102 OCe11102 P008023 01A Rev A gt G EMULEX 4 Using the emlxdrv Utility 51 Interactive Mode of Operation for emlxdrv The definitions of headings for the FC driver configuration table Table 4 1 FC Driver Configuration Table Heading Descriptions Heading FC Driver Description The type of FC driver emlxs elxfc Ipfc or for none that is currently configured to 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
33. d The user types emlxadm the pattern string SUNW emlxs 2 and the command get_num_devs emlxadm SUNW emlxs 2 get_num_devs The elxadm utility returns some status but pauses for a response before running the command Found path to 2 HBA port s HBA port devices pci le 600000 SUNW emlxs 2 fp 0 0 devetl gt Do you wish to continue with this device y n q y ed 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 devctl gt Do you wish to continue with this device y n q y Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 19 gt EMULEX CLI Mode of Operation for emlxadm eo After the user types y the emlxadm utility runs the command There are 0 devices reported on this port Running a Command without User Verification Using y If you do not want the emlxadm utility to pause for verification before running the command include the y option after the pattern string For example when the user types emlxadm the y option 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 l
34. desc Verbose mask for warning messages to the messages file Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 44 gt G EMULEX Command Descriptions for emlxadm label log errors min 0x0 current Oxffffffff max Oxffffffff default Oxffffffff dynamic yes desc Verbose mask for error messages to the messages fil label num iocbs min 128 current 1024 max 10240 default 1024 dynamic no desc Number of outstanding IOCBs driver can queue to adapter label ub bufs min 40 current 1000 max 16320 default 1000 dynamic no desc Number of unsolicited buffers the driver should allocate label network on min 0 current 1 max 1 default 1 dynamic no desc Enable IP processing label ack min 0 current 0 max 1 default 0 dynamic no desc Enable ACKO support label topology min 0 current 0 max 6 default 0 dynamic no desc Select Fibre Channel topology Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A we 3 Using the emlxadm Utility 45 Se EMULEX Command Descriptions for emlxadm label link speed min 0 current 0 max 4 default 0 dynamic no desc Select link speed label num nodes min 2 current 512 max 512 default 512 dynamic no desc Number of fibre channel nodes NPorts the driver will support label cr delay min 0 current 0 max 63 default 0 dynamic no
35. displayed using the get_host_attrs command page 30 The lt index gt argument is an index into this list Example emlxadm gt get_path 0 Adapter pci le 600000 SUNW emlxs 2 fpG 0 0 emlxadm gt get_path 1 Adapter pci le 600000 SUNW emlxs 2 1 fp 0 0 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 34 Command Descriptions for emlxadm gt EMULEX get_phy_attrs Shows the current physical layer PHY module attributes of the HBA This command applies to UCNAs only Example emlxadm gt get_phy_attrs PHY Attributes PHY Type XAUI Interface Type CX4 10 GB Flags 0x00000000 get_port_attrs lt index gt lt wwn gt all Shows the current adapter API port attributes All of the ports attributes can be displayed or a single port can be specified by lt index gt or lt wwn gt The total number of ports available can be seen in the Number of Discovered Ports attribute displayed using the get_host_attrs command The lt index gt argument is an index into this list Example emlxadm gt get_port_attrs all Host Port Attributes Last Change 5 fp Instance e Node WWN 20000000C942097E Port WWN 10000000C942097E Port 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 00000000 0
36. download_boot tu ENEE EEN EEN EEEREN EEEE EEEE 25 EE WeOde SMleMaMme ees EE EE Ee 26 download Tw EIERE REESEN ENEE ECKER EES EEESEE EEN EE EENS 26 force JUMP EE 27 GEE DOGE TeV eu egeg Eege E EE EEL ETAN AENEA 27 GEE ENEE tee ee eege EE REES erences 27 get dump E EE 28 get GUMP SIZE aaa a a a EEE EEEE OAS 29 GEE TCO0S E 29 Get TW TOV 600 ege ce ctuanneds iene maps dE ge ENEE 29 GEE NOA ALU Senao aon E E ines saacsuresesceaneerdessessrvaaens 29 De 30 Get host paraMS sre GEES EE ENEE 31 get Eege 32 GEL TINK EE 32 get_logi_paraMS WWD ee gd seceded EES ER EEREAEREE EE seme EES EE 32 get NUM SVS 112i poi ao rE a O E A E en 33 GEL D DE EE EE Ee a EEE E EEEE EEEE EEEE EE EEEE 33 get Phy attis ee dE EE 34 get_port_attrs ndex gt WWA all e 34 get rnid WWD sents vos Sege e t eege ga ge Age AEAEE E EEEE ENEE E 36 get state NW EE 37 GEE SYM DIE Eege EE 37 get Sym Bun 37 Get tHPOCCl e ice er ni EA EEE AAA EEEL A REN ERDE CAREN ERETI TENE DUERI UREN ETSEAN A 37 get EEN 38 EE 38 E E siempre Gace s eure nt aneir semnialaem wimneeg And uenn on ngneianiiaaendarettevervianieieaes 38 NOG nicicnscesvseapsisniive cima sr vienstie bi msebener everest enti A T 39 link status lt 0 10 gt i renaren a na EE a EEEE E EEE D 40 msgbuf all number i interval 2 52 Ccwesecs cavnnersinadeaxet ss kane sunei aber eawetes nan 40 Bee EEN 41 Dv cance tusbwueansiiiestineste vnasdeross borden E NEEE KERANA ETE TRAA ETE ERE 42 Dt get NUM errn ENEE eg dE ra ranges
37. driver configuration table consisting of bindings associations between the FC and NIC drivers emlxs elxfc Ipfc oce and elxnic and a list of Emulex FC and NIC adapter models After the table is prepared the utility displays e FCdriver configuration table e NIC driver configuration table Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt G EMULEX e List of available commands e emlxdrv prompt For example after emlxdrv FC Driver Alias Pres Boot 4 Using the emlxdrv Utility 50 Interactive Mode of Operation for emlxdrv is entered the utility displays the following Oracleemlxs elxfc lpfc Models S S S LP8000S LP9002DC LP10000 LP11000 LPe11000 LPe11004 LPe11000 LPe11004 LPe12000 LPe12000 LPe12000 LP21000 2G Blade LP9002S SBUS LP8000 LP8000DC LP9002 LP9002C LP9402DC LP9802 LP9802DC LP10000DC LP10000ExDC LP11002 LPe11002 LPe11002 LPe12002 LPe12002 LPe12002 LP21002 Adapter LP10000 S LP10000DC S LP11000 S LP11002 S LPe11000 S LPe11002 S LPe12000 OCe10101 OCe11101 elxnic Models OCe10101 OCe11101 elxfc lpfs yes yes y elxfc F800 yes yes y elxfc F900 e yes yes y elxfc F980 e S S elxfc fa00 S S elxfc fd00 S S elxfc fe00 yes S S elxfc fel2 yes yes y elxf
38. e 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 devctl There are 0 devices reported on this port Instance Option in CLI Mode This CLI mode option enables you to use the emlxadm utility as part of a script or another program capable of running system level calls Syntax emlxadm i lt N SFS FCT or all gt y lt cmd gt cmd_option s Arguments N Indicates a specific emlxs driver instance For example N 1 means emlxsl1 N 2 means emlxs2 and N 2 1 means emlxs2 1 SFS Indicates all emlxs driver instances that attached to the Oracle SFS interface FCT Indicates all emlxs driver instances that are attached to the Oracle COMSTAR interface all Indicates all emlxs driver instances y When the y option is included the emlxadm utility runs immediately It does not pause for a verification from the user to continue When the y option is absent the emlxadm utility pauses for a verification from the user before running the command cmd An emlxadm command See Table 3 1 Summary for emlxadm Commands on page 21 cmd_option s Various emlxadm command arguments if applicable Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 20 CLI Mode of Operation for emlxadm Se EMULEX Using emlxadm help for Command Usage in CLI Mode The emlxadm utility offe
39. e driver configuration tables see the Alias column in Table 4 1 on page 51 to its associated devices Each alias is shared by multiple adapter models Example emlxdrv gt clear dev fe00 Updating fe00 Cannot unload module emlxs Will be unloaded upon reboot Done Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt EMULEX Command Descriptions for emlxdrv clear driver emulex 4 Using the emlxdrv Utility 56 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 el el cl ear ear ear emulex fc emulex nic emulex lear driver_name mulex Example emlxdrv gt clear emulex Cannot unload module Will be unloaded upon Updating fc00 Cannot unload module Will be unloaded upon Updating fcl0 Cannot unload module Will be unloaded upon Updating fc20 Cannot unload module Will be unloaded upon Done clear driver oracle emlxs emlxs emlxs emlxs Clears bindings from all drivers to all Emulex branded devices Clears bindings from FC drivers to all Emulex branded devices Clears bindings from all NIC drivers to all Emulex branded devices Clears bindings from a specific driver indicated by its name to all Emulex branded devices reboot reboot reboot reboot Clears
40. e dump size 29 get_fcode_rev Returns the current FCode revision of the adapter 29 get_fw_rev Returns the current firmware revision of the adapter 29 get_hba_attrs Returns the current control attributes for the adapter 29 get_host_attrs Displays all of the current host adapter API attributes 30 get_host_params Returns the FC login parameters of this adapter port 31 get_inst Returns driver instance for this adapter port 32 get_linkinfo Returns the current link status information for the adapter 32 port get_logi_params lt wwpn gt Returns the FC login common service parameters for a 32 specified FC device on the network get_num_devs Returns the number of FC devices currently seen by this 26 adapter port get_path lt index gt Shows the current Solaris device path for a specified 33 adapter port The total number of ports available can be seen in the Number of HBA ports attribute displayed using the get_host_attrs command The lt index gt argument is an index into this list get_phy_attrs Shows the current PHY module attributes of the adapter 34 Note This command applies to UCNAs only get_port_attrs lt index gt Shows the current adapter API port attributes All of the 34 lt wwn gt all ports attributes can be displayed or a single port can be specified by lt index gt or lt wwn gt The total number of ports available can be seen in the Number of Discovered Ports attribute displayed using the get_host_attrs command
41. e following message is displayed lt Expanding emlxu_kit lt version gt sparc tar gt lt Adding new package gt The package is prepared for installation and you are prompted to confirm its installation Do you want to continue with the installation of lt EMLXemlxu gt y n l U 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 lt EMLXemlxu gt was successful The script performs some cleanup and the following messages are displayed lt Cleaning directory gt lt emlxu_install complete gt lt Execute emlxu_remove when ready to uninstall gt The script copies the emlxu_remove script into the working directory with 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 on page 12 for more details You can also delete the emlxu_remove script The emlxu utilities installation is complete The emlxu utilities package s programs are located in the opt EMLXemlxu bin directory 9 You do not have to reboot the system to run a utility program but you must either enter the program s full path name or add the package s bin directory opt EMLXemlxu bin to the system environment s search path To us
42. e the manual man pages provided by the package you must also add the package s man directory opt EMLXemlxu man to the system environment s man path For more information on installing and removing packages see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M man pages Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A EW 2 Installing and Removing Utilities 11 gt C EMULEX Installing the Utilities Installing the Utilities Manually Note If an earlier 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 13 before installing the newer utilities package manually To install the utilities package manually 1 Login as root or su to root 2 Copy the emlxu utilities package from your distribution medium into a directory The emlxu utilities package is a tar file with a name in the following format emlxu_kit lt version gt sparc tar 3 Go to the directory of the tar file cd lt directory gt 4 Extract the emlxu_install script from the tar file tar xvf emlxu_kit lt version gt sparc tar 5 Install the EMLXemlxu utilities package pkgadd d EMLXemlxu 6 The package is prepared for installation and you are prompted to confirm its installation Do you want to continue with the in
43. ed 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 155130 01 1002033 B 1C35 emlxs0 DEBUG 800 ELS sent GA_NXT did fffffc 00011000 00000000 155130 02 1002034 4 00C9 emlxs0O DEBUG 801 ELS comp GA_NXT CT_ACC Rsn 0 Exp 0 020113e1 21000020 155130 02 1002035 B 1C35 emlxs0 DEBUG 800 ELS sent GA_NXT did fffffc 000113e1 00000000 155130 02 1002036 4 00C9 emlxs0O DEBUG 801 ELS comp GA_NXT CT_ACC Rsn 0 Exp 0 020113e2 21000020 155130 02 1002037 B 1C35 emlxs0 DEBUG 800 ELS sent GA_NXT did fffffc 000113e2 00000000 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A Se EMULEX 3 Using the emixadm Utility 41 155130 155130 155130 155130 emlxadm gt 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 emlxs0O DEBUG 800 ELS sent GA_NXT did fffffc 000113e8 00000000 Performs and returns a complete query of the fabric name server E
44. ias 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 LP9002 LP9002C LP9002DC LP9402DC Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 4 Using the emlxdrv Utility 58 SE EMULEX Command Descriptions for emlxdrv elxfc 980 yes yes yes LP9802 LP9802DC elxfc fa00 Gei yes yes yes LP10000 LP10000DC LP10000ExDC elxfc fa00 yes yes yes LP11000 LP11002 elxfc fe00 yes yes yes yes LPe11000 LPel1002 LPe11004 elxfc fe12 yes yes yes LPe11000 LPe11002 LPe11004 elxfc f100 yes yes yes LPe12000 LPe12002 elxfc 111 yes yes yes LPe12000 LPel2002 elxfc 112 yes yes yes LPe12000 LPe12002 elxfc fe05 yes yes yes LP21000 LP21002 elxfc f0a5 T yes yes 2G Blade Adapter emlxs fc00 yes yes LP10000 S LP10000DC S emlxs fcl0 yes yes yes LP11000 S LP11002 S emlxs fc20 yes yes LPe11000 S LPe11002 S emx1s fc40 yes yes LPe12000 S LPe12002 S elxfc 704 yes yes OCe10101 OCel0102 elxfc 714 yes yes yes OCe11101 OCel1102 NIC Driver Alias Pres Oracle oce elxnic Models oce 700 yes OCe10101 OCel0102 elxnic 710 yes O0Ce11101 OCel1102 Available Commands set Sets driver bindings to specified devices clear
45. it quit the emlxdrv utility type q at the prompt emlxdrv gt 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 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 Oracleemlxs elxfc lpfc Models elxfc lpfs yes yes yes LP8000S LP9002S SBUS elxfc F800 yes yes yes LP8000 LP8000DC elxfc F900 e yes yes yes LP9002 LP9002C LP9002DC LP9402DC elxfc F980 yes yes yes LP9802 LP9802DC elxfc fa00 5 yes yes yes LP10000 LP10000DC LP10000ExDC elxfc fa00 z yes yes yes LP11000 LP11002 elxfc fe00 yes yes yes yes LPe11000 LPe11002 LPe11004 elxfc fFel2 yes yes yes LPe11000 LPel1002 LPe11004 elxfc F100 E yes yes yes LPe12000 LPe12002 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 4 Using the emlxdrv Utility 53 gt G EMULEX Command Descriptions for emlxdrv elxfc Elid yes yes yes LPe12000 LPe12002 elxfc F112 yes yes yes LPe12
46. llow the instructions provided in one of the following sections e Installing the Utilities on page 9 e Updating the Utilities on page 13 For more information on installing and removing packages see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M man pages Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A EW 2 Installing and Removing Utilities 13 gt lt EMULEX Updating the Utilities Removing the Utilities Manually To manually remove the EMLXemlxu utilities package 1 Run the package removal command pkgrm EMLXemlxu 2 You are prompted to confirm the package removal Do you want to remove this package y n q UN Enter y The package is prepared for removal 3 You are prompted again for confirmation Do you want to remove this package y n q ed Enter y The following message is displayed Removal of lt EMLXemlxu gt was successful For more information on installing and removing packages see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M man pages Updating the Utilities You can update the utilities package in two ways e Using the emlxu_install script follow the procedure in Installing the Utilities Using the emlxu_install Script on page 9 In this procedure if an earlier version of the emlxu utilities package is installed you are prompted to remove it before installing
47. llowed by a valid command and its command arguments if applicable Syntax emlxadm lt device path gt y lt cmd gt cmd_option s Arguments device path Specifies the full device name for a single adapter or a pattern string for multiple adapters If the pattern string matches any part of an adapter device path the command runs on that adapter y When the y option is included the emlxadm utility runs immediately without pausing for a verification from the user to continue When the y option is absent the emlxadm utility pauses for a verification from the user before running the command cmd An emlxadm command See Table 3 1 Summary for emlxadm Commands on page 21 cmd_option s Various emlxadm command arguments if applicable Device Path Option for a Single Adapter When using the device path option for single adapters the lt device path gt parameter must be the full device name for the single adapter Running a Command with User Verification In this example the emlxadm utility pauses for a verification from the user before running the command The user types emlxadm the full device name devices pci le 600000 SUNW emlxs 2 fp 0 0 devct1 the command get_state and its lt wwpn gt argument 21000020371938fa emlxadm devices pci le 600000 SUNW emlxs 2 fp 0 0 devetl get_state 21000020371938fa Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A EW 3 Using the eml
48. m gt get_inst emlxs0 get_linkinfo Returns the current link status information for the adapter port Example emlxadm gt get_linkinfo Phys MAC Duplex AC Speed MAC Fault Mgmt MAC Duplex AC Speed QOS Link Speed nk Status Mgmt Logical Li ical port 0 Full Duplex 10 Gbps None None None Disabled Link Up get_logi_ params lt wwpn gt Returns the FC login common service parameters for a specified FC device on the network Example emlxadm gt get_logi_params 21000020371938fa Login Parameters 00 00 00 0 20 20 00 0 88 00 08 0 00 00 0 00 00 01 f 21 00 00 2 37 19 38 20 00 00 2 37 19 38 f 00 00 00 0 Solaris FCA Utilities Version 1 08 2 User Manual 0 0 0 2 4 0 a 0 a 0 P008023 01A Rev A EW 3 Using the emlxadm Utility 33 Se 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 00 00 00 00 00 00 00 00 80 00 00 00 00 00 08 00 00 00 00 00 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 get_num_devs Returns the number of FC devices currently seen by this adapter port Example emlxadm gt get_num_devs There are 4 devices reported on this port get_path lt index gt 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
49. n paramters for a specified FC device Return the host parameters Returns the symbolic port name of a device Sets the symbolic port name for a device Returns the symbolic node name of a device Sets the symbolic node name for a device Performs an FC login to a device Performs an FC logout to a device Returns current SFS state of a specified device Remove the FC device from SFS management Request link error status from a specified D_ID Returns the current Fcode revison of the HBA the HBA fcode Returns the current firmware revison of the HBA Download Download the HBA firmware Returns the current boot revison of 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 Returns the port attributes Returns the adapter path Returns the adapter s Vital Product Data VPD Sets or shows the boot code st
50. nt boot code emlxadm gt boot_code Boot code Disabled To enable the boot code emlxadm gt boot_code enable Boot code Enabled To disable the boot code emlxadm gt boot_code disable Boot code Disabled dev_login lt wwpn gt Performs an FC login to an FC device on the network if it is not already logged in Example emlxadm gt dev_login 21000020371938fa Done dev_logout lt wwpn gt Performs an FC logout to an FC device on the network if not already logged out Example emlxadm gt dev_logout 21000020371938fa Done dev_remove lt wwpn gt Removes the specified FC device from Solaris SFS management Caution This command is not supported in the Solaris SFS stack and causes the host operating system to panic diag lt test parameters gt Performs the diagnostics function on the adapter port This command provides support for Emulex specific tests Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility 25 Command Descriptions for emlxadm gt EMULEX lt 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 lt did gt pattern Performs the echo test to a specified port id The pattern parameter is a 4 byte hexadecimal pattern to be used for the test for example 0xA5A5A5A5 emlx_post Performs the power on
51. ode WWN Port WWN Port Fe 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 Number of Discovered Ports get_host_ params 3 Using the emlxadm Utility 31 Command Descriptions for emlxadm EMULEX LIGHTPULSE LP10000DC S 2GB PCI X FIBRE CHANNEL ADAPTER 20000000C942097E none 1001206d 1 11f t3 2006 04 25 11 43 1 50a9testl 1 91b5 c00 Emulex S s9 64 spare v1l 11f t3 20000000C942097E 10000000C942097E 011700 Nport E Online Class 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000120 00000000 00000000 00000000 00000000 00000000 00000000 00000000 none 1Gb 2Gb 1Gb 0x800 bytes 0000000000000000 4 Returns the FC login parameters of this adapter port Example emlxadm gt get_host_params Host Dtype 0 FC4_type proto 0x00000120 0x00000000 State Online Linkspeed 1Gb D_id 11700 LILP 5 Hard Addr 0 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 WWPN 10000000c942097e Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt EMULEX get_inst 3 Using the emlxadm Utility 32 Command Descriptions for emlxadm WWNN 20000000c942097e Returns driver instance for this adapter port Example emlxad
52. ollowing procedure you are prompted to remove it before the script installs the new version To install the emlxu utilities package using the emlx_install script 1 Login as root or su to root 2 Copy the emlxu utilities package from your distribution medium into a directory The emlxu utilities package is a tar file with a name in the following format emlxu_kit lt version gt sparc tar 3 Change to the directory of the tar file cd lt directory gt 4 Extract the emlxu_install script from the tar file tar xf emlxu_kit lt version gt sparc tar emlxu_install Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 2 Installing and Removing Utilities 10 SG EMULEX Installing the Utilities 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 lt Removing old EMLXemlxu package gt 6 Ifan earlier version of the emlxu utilities package is installed you are prompted to remove it Do you want to remove this package y n q eo Enter y The following message is displayed Removal of lt EMLXemlxu gt was successful 7 The script expands the new tar file and begins installing the emlxu utilities package Th
53. ology reset_link wwpn Resets the link of a specified public loop FC device reset_hard Reset the HBA diag 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 lt label gt Gets the value of a specified parameter in the driver parm_set lt label gt lt val gt Sets the value of a specified parameter in the driver msgbuf all lt number gt i interval Returns the driver s internal message log get_host_attrs Returns the host adapter and port attributes get_port_attrs lt index gt lt wwn gt all Returns the port attributes get_path lt index gt Returns the adapter path get_vpd Returns the adapter s Vital Product Data VPD boot_code enable disable Sets or shows the boot code state in this HBA get_rnid wwpn Gets the RNID information for local or specified port get_inst Gets the driver instance 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 D Repeat previous command emlxadm gt hba Selects another adapter with
54. ot supported in the Solaris SFS stack and causes the host operating system to panic diag Performs a diagnostic test on the adapter Two formats are 24 available diag lt 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 25 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 lt filename gt Downloads the specified boot image file to the adapter 25 download_fcode lt filename gt Downloads the specified FCode image file to the adapter 26 download_fw lt filename gt Downloads the specified firmware image file to the adapter 26 force_dump Forces a firmware core dump on the adapter 27 get_boot_rev Returns the current boot revision of the adapter 27 get_dev_list Returns a list of FC devices currently seen by this adapter 27 Solaris FCA Utilities Version 1 08 2 User Manual port P008023 01A Rev A SG EMULEX 3 Using the emlxadm Utility 22 Command Descriptions for emlxadm Table 3 1 Summary for emlxadm Commands Continued Command Syntax Description Page get_dump h Saves the firmware core dump to a file 29 get_dump_size Returns the adapter s firmware cor
55. re Channel Fibre Channel over Ethernet FC FCoE driver e elxfc Emulex distributed FC FCoE Solaris driver does not support Oracle branded devices e Ipfc Legacy Emulex distributed FC SD driver which does not support Oracle branded devices The lpfc driver is available for Solaris 10 but not for Solaris 11 e oce Solaris inbox NIC driver e elxnic Emulex distributed Solaris NIC driver Abbreviations API application programming interface CLI Command line interface D_ID destination identifier ELS Extended Link Service Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 1 Introduction gt G EMULEX Abbreviations 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 HBA host bus adapter iSCSI internet Small Computer System Interface LINIT Loop Initialize ELS command man manual e g man pages NIC network interface card or controller PHY physical layer module RNID Request Node Identification Data ELS SAN storage area network SFS SAN Foundation Software SPARC Scalable Processor Architecture UCNA universal converged networking adapter VPD vital product data WWPN World Wide Port Name Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 2 Installing and Removing Utilities Q gt G EMULEX Compatibility 2 Ins
56. rs 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 interactive mode or emlxadm v or emlxadm i lt N SFS FCT or all gt y lt cmd gt cmd_option s or emlxadm j lt N SFS FCT or all gt y lt cmd gt cmd_option s or emlxadm n lt N or all gt y lt cmd gt cmd_option s or emlxadm m lt N or all gt y lt cmd gt cmd_option s or emlxadm lt device_path gt y lt cmd gt cmd_option s OPTIONS v Display utility version information i lt N gt 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 j lt N gt Executes command on a specific elxfc driver instance Example N 2 for elxfc2 or N 2 1 for lxfte2 1 jSFS Executes command on all SFS elxfc driver instances JFCT Executes command on all FCT elxfc driver instances jall Executes command on all elxfc driver instances n lt N gt Executes command on a specific oce driver instance Example N 2 for oce2 or N 5 for oce5 nall Executes command on all oce driver instances m lt N gt
57. s 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 Command Options l ear lear lear lear all fc all nic all driver_name Example emlxadm gt clear all Updating lpfs Cannot unload module all Clears bindings from all drivers to all devices This is the default value for the clear command Clears bindings from FC drivers to all devices Clears bindings from NIC drivers to all devices Clears bindings from a specific driver indicated by its name to all devices emlxs Will be unloaded upon reboot Updating 800 Cannot unload module Solaris FCA Utilities Version 1 08 2 User Manual emlxs P008023 01A Rev A EW 4 Using the emlxdrv Utility 55 SE EMULEX Command Descriptions for emlxdrv Will be unloaded upon reboot Updating 900 Cannot unload module Ilpfc Will be unloaded upon reboot Updating 980 Cannot unload module Ilpfc 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 clear dev alias Clears the bindings from a valid adapter alias as listed in one of th
58. specified FC device get_host_params Return the host parameters get_sym_pname Returns the symbolic port name of a device set_sym_pname lt string gt Sets the symbolic port name for a device get_sym_nname Returns the symbolic node name of a device set_sym_nname lt string gt Sets the symbolic node name for a device dev_login lt wwpn gt Performs an FC login to a device dev_logout lt wwpn gt Performs an FC logout to a device get_state lt wwpn gt dev_remove lt wwpn gt link_status lt d_id gt get_fcode_rev Solaris FCA Utilities Version 1 08 2 User Manual Returns current SFS state Remove the FC device from Request link error status Returns the current Fcode of a specified device SFS management from a specified D_ID revison of the HBA P008023 01A Rev A 3 Using the emlxadm Utility 39 Command Descriptions for emlxadm gt 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 top
59. stallation of lt EMLXemlxu gt y n eo Enter y The installation progress is indicated 7 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 EMLxXemlxu bin directory 8 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 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 2 Installing and Removing Utilities SG EMULEX Removing the Utilities 12 Removing the Utilities You can remove the emlxu utilities package in three ways e Using the emlxu_install script removes any previous versions of the emlxu utilities package before installing the latest emlxu utilities package See Installing the Utilities Using the emlxu_install Script on page 9 e Using the emlxu_remove script
60. sumes no responsibility for its use nor for any infringements of patents or other rights of third parties that may result Periodic changes are made to information contained herein although these changes will be incorporated into new editions of this manual Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A DE EMULEX Table of Contents 3 Table of Contents List OF Tables nent a egpkgaBEERS E ASERkREAESREEAREEEKERAE RNKERE REENEN SRINATA EAR ABEE RER 6 1 INCFODUCHON ss ep gz eafeg RE EEEREEAERENE EAR ENEE EEEERE RRENEN EAR ERR ER ERR RER 7 DEEN eru gEuR ANERE EN REESEN ERAN ENEE EENS KEEN Ee KENE NSA eR eg 7 Audiente eege EE ENEE ER 7 Supported Drivers gea sege a RER EES ERES REES EES EEN ESA EE RES ER ERR EES RE RER 7 REEEIEEEL ENEE ee EE EE Ee Ee 7 2 Installing and Removing UtilitieS sssssssssnnnnnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 9 Compatibility e sexkg ker ENEASEEEREEERAEEEER ERAN ENEE NEEN REENEN KE ENEE ENER E EPEN rE 9 Installing the Utilities nis rse sees ERSSEEREREEREREEREEEESEEEEREEEEREEEEEEEEEREEEERER SEKR EE REES 9 Installing the Utilities Using the emlxu_install Script eee cette eee 9 Installing the Utilities Manually cc ccccec cee e eee eens eee senses eae eben nee enae ees 11 Removing the Utilitie S aegee see SEENEN ENEE 12 Removing the Utilities Using the emlxu_remove Script 12
61. t 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 gt get_throttle WWPN Depth 21000011c6810947 512 21000011c681065 f 512 21000011c68108c0 512 21000011c681061d 512 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 3 Using the emlxadm Utility Command Descriptions for emlxadm gt G EMULEX get_topology Returns the FC network topology of the adapter port Example emlxadm gt get_topology PRIVATE_LOOP Topology get_vpd Displays the current adapter s vital product data VPD Example emlxadm gt get_vpd Vital Product Data Identifier ID FC2G PCI X LP10000DC Oracle Part Number PN LP10000DC S Manufacturer MN Oracle Serial Number SN BG43918495 Description V1 EMULEX LIGHTPULSE LP10000DC S 2GB PCI X FIBRE CHANNEL ADAPTER Model V2 LP10000DC S Program Types V3 T2 83 88 T3 84 T6 83 1T7 83 TB 83 TFF 80 Port Number V4 0 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 gt 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
62. talling 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 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 The emlxadm and emlxdrv utilities are bundled into an emlxu utilities package You can install the emlxu utilities package in two ways e Using the emlxu_install script see Installing the Utilities Using the emlxu_install Script on page 9 e Manually by using pkgadd see Installing the Utilities Manually on page 11 Installing the Utilities Using the emlxu_install Script Note Although it is possible to install emlxu onto one or more clients from a server that procedure is not covered in this document see the Solaris documentation Before installing the emlxu utilities package you must install the Solaris 10 Update 9 or later with Oracle recommended patches Make sure the emlxs or elxfc driver is v2 60k or later and the oce driver is v1 10e or later If an earlier version of the emlxu utilities package is installed in the f
63. ts 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 gt set_sym_pname Emulex Corporation ioctl FCIO_SET_SYM_PNAME Operation not supported Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A Se EMULEX 3 Using the emixadm Utility 48 Command Descriptions for emlxadm set_throttle Temporarily sets the I O queue lt depth gt for a specified remote port s The lt depth gt is the maximum number of concurrent I Os that the driver can send to the specified remote port The default queue depth for an FCP target port is specified by the target depth driver parameter Command Options set_throttle all lt depth gt Sets the lt depth gt for all ports set_throttle fcp lt depth gt Sets the lt depth gt for all FCP target ports set_throttle wwpn lt depth gt Sets the lt depth gt for a specific port Example This example sets the maximum number of concurrent I Os to 512 for all remote ports emlxadm gt set_throttle all 512 WWPN Depth 21000011c6810947 512 21000011c681065 f 512 21000011c68108c0 512 21000011c681061d 512 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A 4 Using the emlxdrv Utility 49 Interactive Mode of Operation for emlxdrv gt G EMULEX 4 Using the emlxdrv Utility The emlxdrv utility binds associates the following FC and NIC drivers to vario
64. us Emulex FC and NIC adapter models respectively FC Drivers e emlxs Solaris inbox FC FCoE driver e elxfc Emulex distributed FC FCoE Solaris driver does not support Oracle branded devices e Ipfc Legacy Emulex distributed FC SD driver which does not support Oracle branded devices The lpfc 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 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 Note The simultaneous use of the Ipfc driver and either of the emlxs or elxfc drivers is not supported Using the Ipfc driver should only be used as a step when migrating complex configurations between drivers Note If you change the driver binding configuration the emlxdrv utility requires a system reboot for the new configuration take effect 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 mlxdrv Displaying Bindings Between Drivers and Adapter Models The emlxdrv program scans the host system and prepares a
65. xadm bytes y or n y Returns a list of FC devices currently seen by this adapter port Example emlxadm gt get_dev_list Device 0 Dtype 0 FC4_type proto 0x00000100 0x00000000 0x00000000 Ox00000000 0x00000000 Ox00000000 0x00000000 0x00000000 State Logged_In D_id 113e1 LILP 0 Hard Addr el WWPN 21000020371938fa WWNN 20000020371938fa Device 1 Dtype 0 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A gt EMULEX 3 Using the emlxadm Utility 28 Command Descriptions for emlxadm FC4_type proto 0x00000100 0x00000000 Ox00000000 0x00000000 Ox00000000 0x00000000 State Logged_In D_id 113e2 LILP 0 Hard Addr e2 WWPN 21000020371939a2 WWNN 20000020371939a2 Device 2 Dtype 0 FC4_type proto 0x00000100 0x00000000 Ox00000000 0x00000000 Ox00000000 0x00000000 State Logged_In D_id 113e4 LILP 0 Hard Addr e4 WWPN 21000020371938a3 WWNN 20000020371938a3 Device 3 Dtype 0 FC4_type proto 0x00000100 0x00000000 Ox00000000 0x00000000 Ox00000000 0x00000000 State Logged_In D_id 113e8 LILP 0 Hard Addr e8 WWPN 2100002037193670 WWNN 2000002037193670 get_dump h Saves the firmware core dump to a file Example Result if a valid dump exists in the driver memory emlxadm gt 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
66. xadm Utility 18 gt EMULEX CLI Mode of Operation for emlxadm The elxadm utility returns some status but pauses for a response before running the command Found path to 1 HBA port s HBA port devices pci le 6000000 SUNW emlxs 2 fpl0 0 devctl gt Do you wish to continue with this device y n q y After the user types y the emlxadm utility runs the command State PORT_DEVICE_LOGGED_IN b Running a Command without User Verification Using y If you do not want the emlxadm utility to pause for verification before running the command include the y option after the full device name For example when the user types emlxadm the y option the full device name the command and its argument the elxadm utility runs command immediately mlxadm devices pci le 600000 SUNW emlxs 2 fp 0 0 devctl y get_state 21000020371938fa Found path to 1 HBA port s HBA port devices pci le 600000 SUNW emlxs 2 fp 0 0 devetl State PORT_DEVICE_LOGGED_IN Device Path Option for Multiple Adapters When using the device path option for multiple adapters use a pattern string for the lt device path gt parameter If the pattern string matches any 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 comman
67. xample emlxadm gt ns Nameserver TYPE Lport PID 0113E1 WWP 21000020371938fa PORT_NAME SEAGATE ST39103FC 0004 WWN 20000020371938fa NODE_NAME null IPA ffffffffffffffff IP_ADDR 0 0 0 0 CLASS Class3 FC4_TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 TYPE Lport PID 0113E2 WWPN 21000020371939a2 PORT_NAME SEAGATE ST39103FC 0004 WWNN 20000020371939a2 NODE_NAME null IPA EELEELELESEL EELS IP_ADDR 0 0 0 0 CLASS Class3 FC4_TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 TYPE Lport PID 0113E4 WWPN 21000020371938a3 PORT_NAME SEAGATE ST39103FC 0004 WWNN 20000020371938a3 NODE_NAME null TPA EFEEEEEEFEFFEEEETE IP_ADDR 0 0 0 0 CLASS Class3 FC4_TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Solaris FCA Utilities Version 1 08 2 User Manual P008023 01A Rev A Se EMULEX 3 Using the emixadm Utility 42 Command Descriptions for emlxadm TYPE Lport PID 0113E8 WWPN 2100002037193670 PORT_NAME SEAGATE ST39103FC 0004 WWNN 2000002037193670 NODE_NAME null IPA fffffffffffffftt IP_ADDR 0 0 0 0 CLASS Class3 FC4_TYPES 00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Repeats the last command Example emlxadm gt get_num_devs There are 4 devices reported on this port emlxadm gt p emlxadm gt get_num_devs There are

Solaris FCA Utilities Version 1.08.2 User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents