Home
        Solaris FCA Utilities
         Contents
1.     Resets the local link  if zero is specified  or the link of a specified FC device on the network   Example     emlxadm gt  reset_link 0  Done     or    emlxadm gt  reset_link 21000020371938fa  Done     set_sym_nname  lt  string  gt     Sets the symbolic FC node name of the adapter to the string provided        Note  This operation is currently not supported by the Solaris Leadville stack        Example     emlxadm gt  set_sym_nname  Emulex Corporation   ioctl  FCIO_SET_SYM_NNAME  Operation not supported    set_sym_pname  lt  string  gt     Sets the symbolic FC port name of the adapter to the string provided        Note  This operation is currently not supported by the Solaris Leadville stack     Example     emlxadm gt  set_sym_pname  Emulex Corporation   ioctl  FCIO_SET_SYM_PNAME  Operation not supported    Solaris FCA Utilities User Manual Page 33    y     gt G EMULEX    Using the emlxdrv Utility  Use the emlxdrv utility to bind  associate  the following drivers to the various models of Fibre Channel  adapters    e emlxs   Oracle distributed Leadville Fibre Channel driver   e elxfc   Emulex distributed Leadville Fibre Channel driver   e Ipfc   Emulex distributed non Leadville Fibre Channel driver   e oce   Oracle distributed NIC driver   e     elxnic   Emulex distributed NIC driver    This utility is used for managing the driver and adapter associations on the host  The emlxs and elxfc  drivers can coexist on the same host  However  a specific adapter model can only be a
2.    Returns a list of configurable parameters    lt label gt    Gets the value of a specified parameter in the driver      lt label gt   lt val gt    Sets the value of a specified parameter in the driver    all    lt number gt    i interval    Returns the driver s internal message log     Returns the host adapter and port attributes    lt index gt    lt wwn gt   all   Returns the port attributes    lt index gt    Returns the adapter path     Returns the adapter s Vital Product Data  VPD     enable  disable    Sets or shows the boot code state in this HBA    wwpn    Gets the RNID information for the local or specified port     Gets the driver instance   Returns the current PHY attributes for the HBA   CNA   s      Exits this program      Returns this help screen     Select another hba      Repeat previous command     Select another adapter with which to interface  This prevents you from having to exit and reenter the    q  h  hba  p  emlxadm gt   hba  program   Example     Solaris FCA Utilities User Manual    Page 26     gt S EMULEX    Available Emulex HBA s     1  SFS emlxs0    devices pci 7c0 pci 0 pci 1 pci 0 2 SUNW emlxs 1 fp 0 0  CONNECTED   2  FCT emlxsl    devices pci 7c0 pci 0 pci 1 pci d0 2 SUNW emlxs 1 1  CONNECTED     Enter an HBA number or zero to exit   link_status  lt d_id gt     Requests and returns the current link error status from the FC device specified by the d_id address   Example     emlxadm gt  link status e8    DID  e8  Link failures  3  0x3   Loss of sy
3.   B 1C35 emlxs0O  DEBUG  800  ELS sent   GA_NXT  did fffffc     000113e8 00000000       ns    Performs and returns a complete query of the fabric name server     Solaris FCA Utilities User Manual Page 27    Example     emlxadm gt  ns    Nameserver     WWPN     PORT NAME   WWNN    NODE_NAME   IPA   IP_ADDR   CLASS   FC4_TYPES        WWPN   PORT_NAME   WWNN    NODE NAME     IPA        IP_ADDR   CLASS   FC4_TYPES     WWPN     PORT NAME   WWNN    NODE_NAME   IPA   IP_ADDR   CLASS   FC4_TYPES        WWPN     PORT NAME   WWNN    NODE_NAME   IPA   IP_ADDR   CLASS   FC4_TYPES              gt G EMULEX    Lport   0113E1  21000020371938fa   SEAGATE ST39103FC  20000020371938fa   null   f  LLLLLLLLLLLLLLE  0 0 0 0   Class3  00000100 00000000  00000000  00000000 00000000  00000000  00000000 00000000    0004     Lport   0113E2  21000020371939a2   SEAGATE ST39103FC  20000020371939a2   null   fELLLLLLLLLLLLLE  0 03 0 40   Class3  00000100 00000000 00000000 00000000 00000000 00000000 00000000 00000000    0004     Lport   0113E4  21000020371938a3   SEAGATE ST39103FC  20000020371938a3   null   fLLLLLLLLLLLLLLE  0 0 0 0   Class3  00000100 00000000  00000000  00000000  00000000  00000000  00000000 00000000    0004     Lport   0113E8  2100002037193670   SEAGATE ST39103FC  2000002037193670   null     EETLLELELECL EES  0 0 0 0   Class3  00000100 00000000  00000000  00000000 00000000  00000000  00000000 00000000    0004     parm_get_num    Returns the total number of configurable parameters     Exampl
4.   Log in as root  or su to root     2  Copy the utilities kit from your distribution medium into a directory  referred to here as   lt directory gt   The utilities kit is a  tar file named something similar to     emlxu_kit  lt version gt  sparc tar   3  Change to the directory where the kit tar file is located by typing   cd  lt directory gt   4  Extract the installation images from the tar file by typing   tar xvf emlxu_kit  lt version gt  sparc tar  5  Install the EMLXemIxu utilities package by typing   pkgadd  d   EMLXemlxu    6  The package is prepared for installation  and you are prompted to confirm the installation with  the following message     Do you want to continue with the installation of  lt EMLXemlxu gt   y n     Enter  lt y gt   The installation 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 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 EMLXemIxu 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
5.  00 0    ened 32   D sissisnnennavannaneseankinesaneannasapeahansaweshasanaaegesnmadavearnatareananseraneataveaacmtaeanentes 32   Of cciiiiinsctcneticcnsanaccauennacasiaaanccaneausnoasaneseansanaaeausaiaceanainacaneadangasna  siooanadanoadeas 32   reset Hard osisiesccecctassscnckusathesadadedasa  aehctabenchebabsaehevabunchebehanenchehanceehehasd 33  reset_link  lt wwpn or zero for local liNK gt      ssssssssssrrrrrrrrrrrrnrrrnrrnnnnnnns 33  Seky AeA INS S SWNG E noa E ETES 33  set_sym_pname  lt  String  gt  0 0    lin i i lili ieee 33   Using the emlxdrv Utility 20    eee e cece eect eee e eee e teat eeeeeeeeeeeeeeeeeeeeeeeeeeeteeeteeeeeeas 34  Modes of Operation  emlxdrv             ccc ceeceeeeeeeeeeccneeeeeeeeeeeeeccaaeeeeeeeeeeeeecaeeeeeees 34  Interactive Mode  CMIXCPV         cccccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeess 34  CLI Mode   MIXCrV       cccccccececeeeeccneeeeeeeeeeeeeecaaaeeeeeeeeeeeecaaaeeeeeeeeeeesncaaaeeeeeees 36  Command Descriptions  CMIXCIV               cceeceeeeeeeeeeeeaeeeeeeeeeeeeeccaaeeeeeeeeeeeennaaees 37  Command Usage          ccccccecceeeeeeeccneeeeeeeeeeeeeccaaeeeeeeeeeeececaeeeeeeeeeeeeeennaeeeeeess 38  Clear  driver  alll 2 2 2 2    ceceecccececceceeeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 38   Clear  driver   alias                 ccccccccceeceecceceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 38   Clear  driver  emule k              eeceeeecececececeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeess 39   Clear  d
6.  S 2GB PCI X FIBRE CHANNEL  ADAPTER   Node WWN   20000000C942097E   Node Symbolic Name   none   Hardware Version   1001206d   Driver Version   1 11   t3  2006 04 25 11 43    Optional ROM Version   1 50a9testl   Firmware Version   1 91b5   Vendor Specific ID   fc00   Number of HBA ports    i   Driver Name   Emulex S s9 64 sparc v1 11f   t3   Last Change   5    fp Instance  e   Node WWN   20000000C942097E   Port WWN   10000000C942097E   Port Fe Id   011700   Port Type   Nport   Port State   Online   Port Supported COS   Class3    Port Supported FC4 Types   00000000  00000000  00000000  00000000   00000000  00000000  00000000  00000000   Port Active FC4 Types   00000120  00000000  00000000  00000000   00000000  00000000  00000000  00000000     Port Symbolic Name   none   Port Supported Speed   1Gb  2Gb   Port Speed   1Gb   Port Max Frame Size   0x800 bytes  Fabric Name   0000000000000000    Number of Discovered Ports   4    get_host_params    Returns the FC login parameters of this adapter port   Example     emlxadm gt  get_host_params    Host   Dtype  0  FC4 type proto   0x00000120  0x00000000  0x00000000  0x00000000  0x00000000   0x00000000  Ox00000000  O0x00000000  State  Online  Linkspeed  1Gb  D_id  11700  LILP  5  Hard Addr  0  WWPN  10000000c942097e  WWNN  20000000c942097e    Solaris FCA Utilities User Manual Page 20    get_inst    Returns driver instance for this adapter port     Example     emlxadm gt  get_inst  emlxs0    get_linkinfo    Returns the current link status 
7.  State  PORT DEVICE LOGGED _ IN       get_sym_pname    Returns the symbolic FC port name of the adapter port        Note  This operation is currently not supported by the Solaris Leadville stack     Example     emlxadm gt  get_sym_pname  ioctl  FCIO_GET_SYM_PNAME  Operation not supported    get_sym_nname    Returns the symbolic FC node name of the adapter port        Note  This operation is currently not supported by the Solaris Leadville stack        Example     emlxadm gt  get_sym_nname  ioctl  FCIO_GET_SYM_NNAME  Operation not supported    get_topology  Returns the FC network topology of the adapter port     Example     emlxadm gt  get_topology  Topology  PRIVATE LOOP    get_vpd  Displays the current adapter s vital product data  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    Solaris FCA Utilities User Manual Page 25    Program Types  Port Number    h           EMULEX     V3   T2 83 88 T3 84 T6 83 T7 83 TB 83 TFF 80   V4   0    Shows a help menu of utility commands     Example     emlxadm gt  h    Available commands     get_num_devs  get_dev_list  get_logi_params  get_host_params  get_sym_pname  set_sym_pname  get_sym_nname  set_sym_nname  dev_login  dev_logout  get_state  dev_remove  link status  get_fcode_ rev 
8.  attributes  page 18  get_host_params Returns the FC login parameters of this adapter port  page 20  get_inst Returns the driver instance  page 21  et lodi parame  lt  wwons Returns the FC login common service parameters for age 21  get_logi_p p a specified FC device on the network  pag  Returns the number of FC devices currently seen by  get_num_devs   page 16  this adapter port   Shows the current Solaris device path for a specified  adapter port  The total number of ports available can  get_path  lt index gt  be seen in the  Number of HBA ports  attribute page 22  displayed using the get_host_attrs command  The   lt index gt  argument is an index into this list   Shows the current PHY  physical transceiver  get_phy_attrs connection  attributes of the adapter  This command page 22  applies to converged network adapters only   Shows the current adapter API port attributes  All of  the port attributes can be displayed  or a single port  st pon ale cides ewer   22  be specified by  lt index gt  or  lt wwn gt   The total  A  port i number of ports available can be seen in the  Number   page 22  of Discovered Ports  attribute displayed using the  get_host_attrs command  The  lt index gt  argument is an  index into this list   get_rnid  wwpn  Retrieves the RNID information for the local or  page 24    Page 12       J    Table 1  Alphabetical Listing of All Commands  Continued      gt G EMULEX       Command    Description    For an  example  refer to           Returns the current 
9.  choice of a graphical user interface and a scriptable command line interface  It  is intended to be a direct user interface to the Fibre Channel input output  FCIO  interface provided by  the Oracle StorEdge SFS  The FCIO interface provides a Oracle common ioctl interface to the FCTL  driver  which manages the FCA drivers for each Fibre Channel adapter attached to the host system        Note  The OneCommand Manager application is supported only for LightPulse adapters  and not for OneConnect adapters  The Solaris FCA utilities are supported for all  adapters        Modes of Operation  emlxadm     The emlxadm utility program can be run in two modes     e Interactive    Command line interface  CLI     Interactive Mode  emlxadm     The emlxadm utility program can be run in an interactive command mode by typing the name of the  program without any command line arguments  For example       emlxadm    After the utility is started  the emlxadm program scans the host system and prepares a list of qualified  adapter ports  Qualified adapter ports are devices that attach to the emlxs driver or the oce driver  After  the list is prepared  the utility presents the following information     Available Emulex HBA s     1  SFS emlxs0    devices pci 0 0 pcildde  5d c pcildd   e602 0 2 fp 0 0  CONNECTED   2  NIC oce0d    devices pci 0 0 pcildde  5d c pcildd   e602 0  CONNECTED   3  SFS emlxsl    devices pci 0 0 pcildde  5d c pcildd   e602 0 3 fp 0 0  CONNECTED   4  NIC ocel    devices pci 0 0
10.  commands  For a detailed explanation of each    Solaris    FCA Utilities User Manual Page 35          a      EMULEX    command and its arguments  see    Command Descriptions  emlxdrv     on page 37     Below the command list is an emlxdrv gt  prompt  From this point  the utility is prompt driven  When the  prompt is displayed  you must enter one of the commands in the list  The current driver configuration  table and the available command list are displayed automatically after each command is issued     Some commands require 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     CLI Mode  emIxdrv     The emlxdrv utility program can be run in CLI mode by typing the name of the program followed by a  valid command and any required command arguments  For example  you can update the a device  binding by entering all the information on one line at the operating system prompt as shown below     This mode of operation enables you to use the emlxdrv utility as part of a script or another program  capable of executing system level calls     FC                   nriscer Alias Pres Boot Oracle emlxs elxfc Ipfc Models   elxfc lpfs   7   yes yes yes LP8000S  LP9002S  SBUS    elxfc   800   7 7 yes yes yes LP8000  LP8000DC   elxf
11.  download_fcode  get_fw_rev  download_fw  get_boot_rev  download_boot  reset_link  reset_hard  diag       ns  parm_get_num  parm_get_list  parm_get  parm_set  msgbuf  get_host_attrs  get_port_attrs  get_path  get_vpd  boot_code  get_rnid  get_inst  get_phy attrs  Only      FCIO rev2                Returns the number of FC devices seen by this HBA     Returns a list of FC devices seen by this HBA    lt wwpn gt    Returns the login parameters for a specified FC device   z Return the host parameters     Returns the symbolic port name of a device    lt string gt    Sets the symbolic port name for a device     Returns the symbolic node name of a device    lt string gt    Sets the symbolic node name for a device    lt wwpn gt    Performs an FC login to a device    lt wwpn gt    Performs an FC logout to a device    lt wwpn gt    Returns current SFS state of a specified device    lt wwpn gt    Remove the FC device from SFS management    lt d_id gt    Request link error status from a specified D_ID     Returns the current Fcode revision of the HBA    filename    Download the HBA fcode     Returns the current firmware revison of the HBA    filename    Download the HBA firmware     Returns the current boot revison of the HBA    filename    Download the HBA boot image    wwpn    Resets the link of a specified FC device     Resets 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  
12.  gt 56 EMULEX  Solaris FCA Utilities    Version 1 06    User Manual    ulex Connects      P007005 01A Rev  A Servers   e rage and People     gt S EMULEX    Copyright    2003 2011 Emulex  All rights reserved worldwide  No part of this document may be reproduced by any  means or translated to any electronic medium without the prior written consent of Emulex     Information furnished by Emulex is believed to be accurate and reliable  However  no responsibility is assumed by  Emulex for its use  or for any infringements of patents or other rights of third parties which may result from its use   No license is granted by implication or otherwise under any patent  copyright or related rights of Emulex     Emulex  the Emulex logo  AutoPilot Installer  AutoPilot Manager  BlockGuard  Connectivity Continuum   Convergenomics  Emulex Connect  Emulex Secure  EZPilot  FibreSpy  OneCommand Manager  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  
13.  path     Removing the Utilities Package Manually    To manually remove the EMLXemixu utilities package    1  Type   pkgrm EMLXemlxu   2  You are prompted to confirm the removal by the following message   Do you want to remove this package   y n   q    3  Enter  lt y gt   The package is prepared for removal  and you are prompted again for confirmation   Do you want to remove this package   y n   q    4  Enter  lt y gt   The following message is displayed     Removal of  lt EMLXemlxu gt  was successful    For additional information on installing and removing packages  refer to the Solaris system  administration documentation and the pkgadd 1M  and pkgrm 1M  manual pages     Solaris FCA Utilities User Manual Page 4    J      gt G EMULEX    Updating the Utilities Package Manually    To manually update the EMLXemlxu utilities package   1  Remove the existing emlxu utilities package as detailed in    Removing the Utilities Package  Manually    on page 4   2  Install the new emlxu utilities package as detailed in    Installing the Utilities Package Manually     on page 4     Solaris FCA Utilities User Manual Page 5    y      EMULEX    Using the emlxadm Utility    The emlxadm utility is used to change driver parameters through a local interactive or command line  interface  It can also be used for firmware updates on non Oracle branded devices  The OneCommand  Manager application provides the same functions as emlxadm  and a number of additional ones  on  multiple systems  through a
14.  pcildde  5d c pcildd   e602 0 1  CONNECTED   5  FCT emlxs2    devices pci 0 0 pcildde  5d d pcildd  t    100 0  CONNECTED   6  SFS emlxs3    devices pci 0 0 pcildde  5d d pcildd     100 0 1 fp 0 0  CONNECTED     Enter an HBA number or zero to exit     Enter an HBA number or zero to exit  You must choose from one of the available adapters in the list by  entering the appropriate number  In this example  the term SFS indicates that the corresponding adapter  port is attached to the Oracle SFS stack  The term FCT indicates that the corresponding adapter port is  attached to the Oracle COMSTAR stack  The term NIC indicates that the corresponding adapter port is  attached to the Oracle networking stack  If you select the adapter port that has attached type SFS or    Solaris FCA Utilities User Manual Page 6     gt S EMULEX    FCT  the utility presents the following list of command options     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   get_dump   h   get_topology   reset_link  wwpn   reset_hard   diag   ns   parm_get_num  parm_get_list   parm_get  lt label gt   par
15. 00 yes     yes yes yes pee ee Deere  LPe11004       Solaris FCA Utilities User Manual Page 34    FC  Driver    elxfc    lxfc  lxfc  lxfc    lxfc       ooo O    lxfc  emlxs  emlxs  emlxs  emxls  elxfc    elxfc    NIC  Driver    oce    elxnic    y     gt G EMULEX       Alias Pres Boot Oracle emlxs elxfc lpfc Models   fel2 E _ 7 yes yes yas LPe11000  LPe11002   LPe11004     100       yes yes yes LPe12000  LPe1l2002     111       yes yes yes LPe12000  LPe12002   f112       yes yes yes LPe12000  LPe1l2002   fe05       yes  yes yes LP21000  LP21002     0a5       yes yes   2G Blade Adapter     c00     yes  yes 7   LP10000 S  LP10000DC S   fc10 yes   yes yes     LP11000 S  LP11002 Ss     c20     yes yes     LPe11000 S  LPe11002 S     c40     yes yes     LPe12000 S  LPe12002 S   704       yes  yes   OCe10101  OCe10102   714 yes   s yes yes   O0Ce11101  OCe11102   Alias Pres Oracle oce elxfc Models   700     yes yes OCe10101  OCe10102   710     yes yes OCe11101  OCe11102    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     The display comprises three parts  the current driver configuration table  a list of available commands    and the    emlxdrv prompt  not shown above      The driver configuration table contains the following columns of data     Driver   Which driver  emlxs  Ipfc or     if none  is currently configured 
16. 1938FA  Port WWN   21000020371938FA  Port Fc Id   0113e1  Port Type   Unknown  Port State   Unknown  Port Supported COS   Class3  Port Supported FC4 Types   00000000  00000000  00000000  00000000   00000000  00000000  00000000  00000000   Port Active FC4 Types   00000000  00000000  00000000  00000000   00000000  00000000  00000000  00000000   Port Symbolic Name   SEAGATE ST39103FC 0004  Port Supported Speed   Unknown  Port Speed   Unknown  Port Max Frame Size   0x0 bytes  Fabric Name   0000000000000000  Port  1  Attributes   Node WWN   20000020371938A2  Port WWN   21000020371938A2  Port Fc Id   0113e2  Port Type   Unknown  Port State   Unknown  Port Supported COS   Class3  Port Supported FC4 Types   00000000  00000000  00000000  00000000   00000000  00000000  00000000  00000000   Port Active FC4 Types   00000000  00000000  00000000  00000000   00000000  00000000  00000000  00000000   Port Symbolic Name   SEAGATE ST39103FC 0004    Solaris FCA Utilities User Manual           EMULEX    Page 23    Port Supported Speed  Port Speed   Port Max Frame Size  Fabric Name    Port  2  Attributes      gt S EMULEX      Unknown     Unknown     0x0 bytes     0000000000000000      2000002037193983    2100002037193983    0113e4     Unknown     Unknown     Class3    00000000   00000000     00000000   00000000     00000000  00000000   00000000  00000000     SEAGATE ST39103FC    Unknown    0004      Unknown    Node WWN   Port WWN   Port Fc Id   Port Type   Port State   Port Supported COS   Port Su
17. Emulex  assumes no responsibility for its use  nor for any infringements of patents or other rights of third parties that may  result  Periodic changes are made to information contained herein  although these changes will be incorporated into  new editions of this manual  Emulex disclaims any undertaking to give notice of such changes     Emulex  3333 Susan Street  Costa Mesa  CA 92626    Solaris FCA Utilities User Manual Page ii    alicore lie  Ie   eee ereeeee sree eerie neerre AE errr ere ere ee E 1  Installing the Utilities 000 lll ll ll lll ll ln nnn nn aaa 1  Compatibilty fet ates tote c2ctetstctatenct tet ctecctetenctc ctctehctetet tetetetss tetetcteeetcscteaa ecctecaeeres 1  Installing or Updating the Utilities Using the emlxu_install Script          00  00 1  Removing the Utilities Using the emlxu_remove Script              c ccceeeeeeeeeeeeeeees 3  Installing the Utilities Package Manually            ee ceeeeeeeeeeeeeeeeeeeeeeteeeeeeees 4  Removing the Utilities Package Manually    4  Updating the Utilities Package Manually             eeecccccceeeeeeeeeeeeeeeeeeeeeeteeeeeeeenees 5  Using the emlxadm Utility   0 000 lll nn nn nn nn nn nn AEAEE AEAEE EEEE 6  Modes of Operation  emlxadm                 cceeeeeeceeeeeeeeeeeeeeeeeeeecaeeeeeeeeeeeeetaeeeeeenee 6  Interactive Mode  CMIXadM            cc ceeeeeeeeeeeeeeeeeeeeeeeeaaaaaaaaaaaaaaaaaaaaaaaaaeeeeeeeees 6  CLI Mode  CMIXAGM   ssassn ed 8  Device Path Option         sssssssssesesessssssirrrsesssrtrrrnrtsssstnrrrn
18. Leadville state of the specified FC                                                 get_state  lt wwpn gt  device on the network  page 25  Returns the symbolic FC node name of the adapter  port   get_sym_nname page 25  Note  This operation is currently not supported by the  Solaris Leadville stack   Returns the symbolic FC port name of the adapter  port   get_sym_pname page 25  Note  This operation is currently not supported by the  Solaris Leadville stack   get_topology Returns the FC network topology of the adapter port  page 25  get_vpd Shows the current adapter s vital product data  VPD   page 25  h Shows a help menu of utility commands  page 26  Allows you to select another adapter with which to  hba interface  This prevents you from having to exit and page 26  reenter the program         Requests and returns the current link error status from  link stat  s  lt 0_id gt  the FC device specified by the D_ID address  page 27  Shows all or part  the last  lt number gt  of lines  of the  current driver message log  and can update the screen  msgbuf all or  lt numbers   i every  lt interval gt  seconds if desired  To stop the  interval  program from updating the screen  press  lt Ctrl gt    lt C gt     page 27  If no interval is provided  the current message log is  displayed with no additional updates  and the  emlxadm prompt returns   Performs and returns a complete query of the fabric  ns page 27  name server   p Repeats the last command  page 32  parm_get  lt label Retriev
19. all oce driver instances   ae Executes command on a specific elxnic driver instance    M lt N gt     y   Example  N 2 for elxnic2 or N 5 for elxnic5    mall  Executes command on all oce driver instances     If a full device path is not specified     then the command will    device_path  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    Command Descriptions  emixadm     option will cause the utility to skip the verification and  automatically execute the command on each device     This section provides a list of commands and descriptions that can be issued with the emlxadm utility     Table 1  Alphabetical Listing of All Commands       Command    Description    For an  example  refer to           boot_code  enable or disable     Sets or shows the boot code state of the current  adapter     page 14       dev_login  lt wwpn gt     Performs an FC login to an FC device on the network   if not already logged in     page 14       dev_logout  lt wwpn gt     Performs an FC logout to an FC device on the  network  if not already logged out     page 14       dev_remove  lt wwpn gt     Removes the specified FC device from Leadville  management     Warning  This command is currently not properly  supported in the Leadville stack and will cause the  host operating system to panic     page 15       diag  lt test  parameters  gt  or dia
20. at adapter alias  emlxdrv only updates  the system configuration for the next boot     Solaris FCA Utilities User Manual Page 41    Example     emlxdrv gt  set emlxs_ all    Updating lpfs   Updating   800   Updating   900       Cannot unload module  lpfc  Will be unloaded upon reboot     Updating   980  Cannot unload module  lpfc  Will be unloaded upon reboot     Updating fa00  Updating fd00  Updating fe00  Updating fc00  Updating fc10  Updating fc20  Done     set  driver  oracle    Sets the driver to bind to all Oracle devices   Example    emlxdrv gt  set emlxs_sun   Updating fc00   Updating fc10    Updating fc20  Done     set  driver name   emulex     Sets the driver to bind to all Emulex branded devices     y           EMULEX    You may see the message  Cannot unload module   This indicates that you must reboot the system to  get a driver to unbind from that adapter alias  emlxdrv only updates the system configuration for the next    boot    Example    emlxdrv gt  set lpfc fa00  Updating fa00   Cannot unload module  emlxs    Will be unloaded upon reboot   Done     Solaris FCA Utilities User Manual    Page 42    
21. ating fe00  Cannot unload module  emlxs  Will be unloaded upon reboot     Done   clear  driver   alias     Clears the driver bindings to specified devices based on the specified driver parameter  Select one of  the following driver parameters     e all   clears bindings to specified devices for all drivers  This is the default value for this  parameter     Solaris FCA Utilities User Manual Page 38    y     gt G EMULEX    e fc   clears bindings to specified devices for Fibre Channel drivers   e nic   clears bindings to specified devices for NIC drivers   e  driver_name    clears bindings to specified devices for a specific driver     You must specify one of the adapter aliases listed on the screen  Each alias is shared by multiple  adapter models  Driver bindings can be made only with an adapter alias and not with a specific adapter  model     You may see the message  Cannot unload module   This indicates that you must reboot the system to  get a driver to unbind from that adapter alias  emlxdrv only updates the system configuration for the next  boot     Example     emlxdrv gt  clear dev fe00    Updating fe00   Cannot unload module  emlxs  Will be unloaded upon reboot   Done     clear  driver  emulex  Clears the driver bindings to Emulex branded devices based on the specified driver parameter  Select  one of the following driver parameters     e all   clears bindings to Emulex branded devices for all drivers  This is the default value for this  parameter     e fc  clears bind
22. c   900       yes yes yes DP20927 ane   LP9002DC  LP9402DC   elxfc   980       yes yes yes LP9802 LP9802DC   elxfc   a00       yes yes yes Sree ee LEL000ODE   LP10000ExXDC   elxfc   d00   5 s yes yes yes LP11000  LP11002   elxfc fe00 yes     yes yes yes esr on eae  LPe11004   elxfc fe12 E E 2 yes yeg yas LPe11000  LPe11002   LPe11004   elxfc   100       yes yes yes LPe12000  LPe12002   elxfc   111     s yes yes yes LPe12000  LPe12002   elxfc   112   7   yes yes yes LPe12000  LPe12002   elxfc fe05       yes  yes yes LP21000  LP21002   elxfc   0a5   7   yes yes   2G Blade Adapter   emlxs   c00   7 yes  yes z   LP10000 S  LP10000DC S   emlxs fc10 yes 7 yes yes     LP11000 S  LP11002 S   emlxs   c20     yes yes z   LPe11000 S  LPe11002 S   emxls   c40   7 yes yes     LPe12000 S  LPe1l2002 S   elxfc 704       yes  yes   OCe10101  OCe10102   elxfc 714 yes   s yes yes   O0Ce11101  OCel11102   elxfc e200   7   yes yes   OCe16001  OCe16002   elxfc e260       yes yes   O0Ce50102   NIC   i    acess Alias Pres Oracle oce elxnic Models   oce 700     yes yes OCe10101  OCe10102   elxnic 710   z yes yes OCe11101  OCe11102    Solaris FCA Utilities User Manual    Page 36    Command Descriptions  emIxdrv      gt S EMULEX    This section provides a list of commands that can be issued with the emlxdrv utility program     You can view the list of commands at any time by running the emlxdrv utility in interactive mode  see     Interactive Mode  emlxdrv     on page 34      Table 2  Alphabetical List
23. e     Solaris FCA Utilities User Manual    Page 28     gt S EMULEX    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  1  max  2  default  1  dynamic  yes  desc  Sets the Fibre Channel ADISC login support level     parm_get_list    Returns a list of configurable parameters   Example     emlxadm gt  parm_get_list    Parameter   label  console notices  min  0x0  current  0x0  max  Oxffffffff  default  0x0  dynamic  yes  desc  Verbose mask for notice messages to the console   label  console warnings  min  0x0  current  0x0  max  Oxffffffff  default  0x0  dynamic  yes  desc  Verbose mask for warning messages to the console   label  console errors  min  0x0  current  0x0  max  Oxffffffff  default  0x0  dynamic  yes  desc  Verbose mask for error messages to the console   label  log notices  min  0x0  current  Oxffffffff  max  Oxffffffff  default  Oxffffffff    Solaris FCA Utilities User Manual Page 29    min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current      gt S EMULEX    yes  Verbose mask for notice messages t
24. eeeeeesaaaaeeeeeeees 18   CE NOSL AtS emiir AN ence satnengcaigaans 19  get_host_paramS            ccccccccceceeeeeeeeeeeeeeaaeeeeeeeeeeeeeaaaaeeeeeeeeeeeeaaaanieeeess 20   ge PIS iea E A A E A A E 21  getlinkinfo 22    eee ce cece cece eee eeeeeeeeeeeeeeaaaeeeeeeeeeeeaaaaaeeeeeeeeeeeaaaaneeneeees 21   get logi params  lt WWOND            cccccceeeeeeeeeceeeeeeeeeeeeeeeeaaaeaeeeeeeeeeeeaaaeeees 21   get _MUM_COVS           ccceeccceeee cece eeeeeeeeeeeeeaaeeeeeeeeeeesaaaaaaeeeeeeeeesaaaaeeeeeeess 22   GSl  Pal  lt INGOKS ciston iadnn aa a aaa aeiiae 22  Jerom a e T T EE 22  get_port_attrs  lt index gt    lt wwmn gt  OF All        ssssssssssssssnrrrssrssssnnnrrrrrsssnnnnnne 22  gerria  WWE eRe 24   g  t  Stale  lt WWONS mensas a E A EE 25   g  t sym pPnhame siniese aeaa aaaea yas 25   g  t sym  ANNAME wreic aranana anaana i Ea aa E aa aE SE RE 25   CSU eaea e 85 oc cee ere EA 25   COU VG E E E exasened exes ened exes ened exes ened exes ened eee ne nese Pee 25   aeoe e E 26   alere ET AAA 26  link_status  lt C_id gt         ceccccceccccccseecceceeeeeeeeaeseeeceeseeeseeeeeesaeeseeesaeseesaaes 27  msgbuf all or  lt number gt    i interVal           ccc 27   NS ee ctene ee abuse cteu pure lcestaete tere netieseaseecctuaetet opcaetecogcaunesceuaetorssenctensasac cs 27    Solaris FCA Utilities User Manual Page iii    PAM GOL NU Miksik Eaa EEE NEERA RERS 28  parm_get  lt label gt  oe    eee eee itaniti ninani nni EEEE 29   Palin  Get liSt acs 29  parm_set  lt label gt   lt ValUC gt 
25. er       c00   yes yes z 7 LP10000 S  LP10000DC S   z f  c10   yes yes   7 LP11000 S  ULP11002 S     fc20 yes yes yes     LPe11000 S  LPe11002 S       c40   yes yes   7 LPe12000 S  LPe12002 S   elxfc 704 yes 5 yes yes   O0Ce10101  OCe10102   elxfc 714 yes   yes yes   O0Ce11101  OCe11102   NIC     neler Alias Pres Oracle oce elxfc Models   elxnic 700 yes   yes yes OCe10101  OCe10102   elxnic 710 yes   yes yes O0Ce11101  OCe11102   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     set emlxs  driver_name   alias     Sets the driver to bind to the specified devices  You must specify one of the valid adapter aliases listed  on the screen  Note that each alias is shared by multiple adapter models  Driver bindings can be made  only with an adapter alias and not with a specific adapter model     You may see the message  Cannot unload module   This indicates that you must reboot the system to  get a driver to unbind from that adapter alias  emlxdrv only updates the system configuration for the next  boot     Example     emlxdrv gt  set emlxs   980    Updating   980  Cannot unload module  lpfc  Will be unloaded upon reboot     Done   set  driver  all    Sets the driver to bind to all devices  You may see the message  Cannot unload module   This indicates  that you must reboot the system to get a driver to unbind from th
26. erforms an FC login to an FC device on the network  if not already logged in     Example     emlxadm gt  dev_login 21000020371938fa  Done     dev_logout  lt wwpn gt     Performs an FC logout to an FC device on the network  if not already logged out   Example     emlxadm gt  dev_logout 21000020371938fa  Done     Solaris FCA Utilities User Manual    Page 14       y     gt G EMULEX    dev_remove  lt wwpn gt     Removes the specified FC device from Leadville management        WARNING  This command is currently not properly supported in the Leadville stack and will cause the  host operating system to panic        diag  lt test  parameters  gt  or diag code  lt cmd_code  hex  gt     Performs the diagnostics function or command code on the adapter port  This command provides  support for the Emulex specific tests shown below  or generic support to issue an adapter specific  diagnostic code  in hexadecimal  to any third party adapter     Tests   emlx biu  pattern    Performs the Bus Interface Unit test   emlx_echo  lt did gt   pattern    Performs the ECHO test to a specified port id   emlx_post   Performs the Power On Self Tests    Parameters     pattern   4 byte hex pattern to be used for test   e g  OxXA5A5A5A5   Example     emlxadm gt  diag emlx biu  Result  EMLX_DIAG BIU  Operation successful     or    emlxadm gt  diag emlx_echo fffffc  Result  EMLX_DIAG ECHO  Operation successful     or    emlxadm gt  diag emlx post  Result  EMLX_DIAG POST  Operation successful     Example     e
27. es the value of a specified parameter in the page 29  driver   parm_get_list Returns a list of configurable parameters  page 29  parm_get_num Returns the total number of configurable parameters  page 28  parm_set  lt  abel gt   lt value gt  Sets the value of a specified parameter in the driver     page 32  Only dynamic parameters can be set   q Exits the utility program  page 32       Solaris FCA Utilities User Manual    Page 13       J    Table 1  Alphabetical Listing of All Commands  Continued      gt  EMULEX                   Note  This operation is currently not supported by the  Solaris Leadville stack              Command Description ronan  example  refer to   reset nard Forces the adapter to perform a hardware reset  page 33  aak WD OF Zero Tor ocat Resets the local link  if zero is specified  or the link of a age 33  specified public loop FC device on the network  pag  Sets the symbolic FC node name of the adapter to the  string provided   set_sym_nname  lt  string  gt  page 33  Note  This operation is currently not supported by the  Solaris Leadville stack   Sets the symbolic FC port name of the adapter to the  string provided   set_sym_pname  lt  string  gt  page 33       Command Usage  boot_code  enable or disable     Sets or shows the boot code state of the current adapter   Example   emlxadm gt  boot_code    Boot code  Disabled    emlxadm gt  boot_code enable  Boot code  Enabled       emlxadm gt  boot_code disable  Boot code  Disabled    dev_login  lt wwpn gt   P
28. ex utility programs are provided on the Emulex website  Download the utilities from the Emulex  website after selecting the appropriate Solaris SFS operating system version     Compatibility    The Emulex drivers for Solaris and the FCA utilities support the following operating systems   e Solaris 10 for SPARC  e Solaris 10 for x64 and x86  e Solaris 11 Express for SPARC  e Solaris 11 Express for x64 and x86    To determine which adapters are supported by the Solaris SFS FCA  emlxs  elxfc  drivers  Solaris  Ethernet NIC  oce  elxnic  drivers and the Emulex Fibre Channel adapter utilities  FCA utilities   refer to  the Emulex website        Note  The OneCommand Manager application is supported only for LightPulse adapters  and not for OneConnect adapters  The Solaris FCA utilities are supported for all  adapters     Installing or Updating the Utilities Using the emlxu_install Script    Although it is possible to install emlxu onto one or more clients from a server  that procedure is not  covered in this document  refer to the Solaris documentation     Before installing the Emulex emlxu utilities package  you must completely install the Solaris 10 Update 8   Solaris 10 10 09  with Oracle recommended patches  Make sure the emlxs driver is v2 500  or later   and the oce driver is v1 10c  or later      If an earlier version of the emlxu utilities package is already installed on the system  the emlxu_install  script removes the old version before installing the new version     To i
29. g  code  lt cmd_code  hex  gt           Performs the specified diagnostics function or  command code on the adapter port  This command  provides support for the Emulex specific tests shown  below  or generic support to issue an adapter specific  diagnostic code  in hexadecimal  to any third party  adapter        page 15       Solaris FCA Utilities User Manual    Page 11       J    Table 1  Alphabetical Listing of All Commands  Continued      gt G EMULEX       Command    Description    For an  example  refer to           Downloads the specified boot image file to the                                                             specified port     Solaris FCA Utilities User Manual       download_boot  lt filename gt  adapter  page 15  download_fcode  lt filename gt  Downloads the specified FCode image file to the page 16  adapter   download_fw  lt filename gt  Downloads the specified firmware image file to the  page 16  adapter   force_dump Force a firmware core dump on the adapter  page 16  get_boot_rev Returns the current boot revision of the adapter  page 17  get_dev list Returns a list of FC devices currently seen by this page 17  adapter port   get_dump_size Returns the adapter s firmware core dump size  page 18  get_dump   h  Saves firmware core dump to a file  page 18  get_fcode_rev Returns the current FCode revision of the adapter  page 18  get_fw_rev Returns the current firmware revision of the adapter  page 18  get_host_attrs Displays all of the current host adapter API
30. ibre Channel ADISC login support level     pm support    Solaris FCA Utilities User Manual Page 31    y     gt G EMULEX    min   current    max   default   dynamic  no   desc  Enables power management support     FRR Oo    parm_set  lt  abel gt   lt value gt     Sets the value of a specified parameter in the driver  Only dynamic parameters can be set   Example  This example sets a dynamic parameter     emlxadm gt  parm_set adisc support 2    label  adisc support  min  0  current  2  max  2  default  1  dynamic  yes  desc  Sets the Fibre Channel ADISC login support level        Note  To make this change permanent  you must edit the  kernel drv emlxs conf file        Example  This example attempts to set a static parameter     emlxadm gt  parm_set network on 1  emlxadm  EMLX PARM SET  Parameter  network on  is not dynamic and cannot be changed  here        To make this change you must edit the  kernel drv emlxs conf or        the  kernel drv emlx conf file s  and reboot the system        p    Repeats the last command   Example   emlxadm gt  get_num_devs    There are 4 devices reported on this port     emlxadm gt  p  emlxadm gt  get_num_devs    There are 4 devices reported on this port     q  Exits the utility program     Example     emlxadm gt  q  Exiting       Solaris FCA Utilities User Manual Page 32    J     gt G EMULEX    reset_hard    Forces the adapter to perform a hardware reset   Example     emlxadm gt  reset_hard  Done     reset_link  lt wwpn or zero for local link gt 
31. information for the adapter port     Example     emlxadm gt  get_linkinfo    Physical port    MAC Duplex    MAC Speed    MAC Fault    Mgmt MAC Duplex   Mgmt MAC Speed    QOS Link Speed   Logical Link Status     0   Full Duplex  10 Gbps  None   None   None  Disabled  Link Up    get_logi_params  lt wwpn gt     y           EMULEX    Returns the FC login common service parameters for a specified FC device on the network     Example     emlxadm gt  get_logi_params 21000020371938fa    Login Parameters   00 00 00 00  20 20 00 00  88 00 08 00  00 ff 00 02  00 00 01   4  21 00 00 20  37 19 38 fa  20 00 00 20  37 19 38 fa  00 00 00 00  00 00 00 00  00 00 00 00  00 00 00 00  00 00 00 00  00 00 00 00  00 00 00 00  00 00 00 00  80 00 00 00  00 00 08 00  00 ff 00 00  00 01 00 00  00 00 00 00  00 00 00 00  00 00 00 00    Solaris FCA Utilities User Manual    Page 21    y     gt G EMULEX    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 displayed using the get_host_attrs command  The   lt index gt  argument is an index into this list     Example   emlxadm gt  get_path 0    Adapter   pci le 600000 SUNW  emlxs 2 fp 0 0    emlxad
32. ing of All Commands                               list                 Solaris FCA Utilities User Manual       Emulex branded devices        Command Class Command Description See  Clear  driver   device  Clears the driver bindings  clear  driver  all to all devices  This is the page 38  default setting   Note   driver  can be one of the   5  following  Clears the driver binding  all Alll drivers  default  clear  driver   alias  to the specified devices  page 38  fc All Fibre Channel drivers The driver is ignored   Ha NIC hgh ific dri Clears Emulex branded   oriver  namel  Specific driver clear  driver  emulex driver bindings for a page 39  name specified driver type   Note   device  can be one of the  following   all   All devices  default    alias    Specific device alias    driver  is ignored in this case   emulex   All Emulex branded  adapters  Clears Oracle branded  oracle   All Oracle branded clear  driver  oracle driver bindings for a page 40  adapters specified driver type   You can combine any of the  arguments from the driver list  and the device list   q q Exits the program  page 40  Refreshes the host  bindings and main display  refresh refresh with the latest page 40  information   Set  driver _name   device      Sets the driver to bind to  set  driver_name   alias  a   page 41  the specified devices   Sets the driver to bind to  Note   driver_name  is the name   set  driver_name  all all devices  This is the page 41  of the specific driver you wish to default set
33. ings to Emulex branded devices for Fibre Channel drivers   e nic   clears bindings to Emulex branded devices for NIC drivers   e  driver_name    clears bindings to Emulex branded devices for a specific driver     You may see the message  Cannot unload module   This indicates that you must reboot the system to  get a driver to unbind from that adapter alias  emlxdrv only updates the system configuration for the next  boot     Example   emlxdrv gt  clear emlxs    Cannot unload module  emlxs  Will be unloaded upon reboot     Updating fc00  Cannot unload module  emlxs  Will be unloaded upon reboot     Updating fc10   Cannot unload module  emlxs  Will be unloaded upon reboot   Updating fc20   Cannot unload module  emlxs    Will be unloaded upon reboot     Done     Solaris FCA Utilities User Manual Page 39    y     gt G EMULEX    clear  driver  oracle    Clears the driver bindings to all Oracle devices based on the driver parameter you specify  Select one of  the following driver parameters     e all   clears bindings to Oracle branded devices for all drivers  This is the default value for this  parameter     e fc  clears bindings to Oracle branded devices for Fibre Channel drivers   e nic   clears bindings to Oracle branded devices for NIC drivers   e  driver_name    clears bindings to Oracle branded devices for a specific driver     You may see the message  Cannot unload module   This indicates that you must reboot the system to  get a driver to unbind from that adapter alias  em
34. ion 00f  51010  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   New  Firmware  1 05e 366712  0x59878  bytes    Are you sure you want to download this image   y or n   y    Downloading     Done     force_dump    Force a firmware core dump on the adapter   Example     emlxadm gt  force dump  Done     Solaris FCA Utilities User Manual    Page 16    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    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   0x00000000  O0x00000000  0x00000000  State  Logged In  Did  113e1  LILP  0  Hard Addr  el  WWPN  21000020371938fa  WWNN  20000020371938fa       Device 1    Dtype  0  FC4 type proto   0x00000100  0x00000000  0x00000000   0x00000000  O0x00000000  0x00000000   State  Logged In   D id  113e2   LILP  0   Hard Addr  e2  WWPN  21000020371939a2  WWNN  20000020371939a2    Dtype  0  FC4 type proto   0x00000100  0x00000000  0x00000000   0x00000000  O0x00000000  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  0x00000000   0x00000000  O0x00000000  0x00000000  State  L
35. laris FCA Utilities User Manual Page 2    y      EMULEX    Removing the Utilities Using the emlxu_remove Script    You can uninstall the utilities kit using the emlxu_remove script  If you do not have the emlxu_remove  script and you do not have the original emlxu utilities kit tar file  you must uninstall the emlxu package  manually using the instructions in    Removing the Utilities Package Manually    on page 4  If you are  updating the emlxu utilities to a newer version and you have the new utilities kit tar file  you do not need  to use the emlxu_remove script  the emlxu_install script removes any old version as it installs the newer  version  see    Installing or Updating the Utilities Using the emlxu_install Script    on page 1 for more  details     If you do not want to update the utilities package  and only want to uninstall it  use the emlxu_remove  script     To remove all emlxu files     Log in as root  or su to root     2  Go to the directory where the emlxu_remove script is located  or to the directory where the  original utilities kit tar file is located by typing     cd  lt directory gt     3  If you have the emlxu_remove script  skip to step 4  If you do not have the emlxu_remove script  but you do have the original emlxu utilities kit tar file  extract the emlxu_remove script from the  tar file by typing   tar xf emlxu_kit  lt version gt  sparc tar emlxu_remove   4  Remove the emlxu utilities package by typing   emlxu_remove   5  The script locates the EMLXe
36. lowing statement appears to indicate that the command requires  an argument to be executed  For example     emlxadm gt  get_state   Usage  get_state  lt wwpn gt    emlxadm gt  get_state 21000020371938fa  State  PORT DEVICE LOGGED IN       If you select the adapter port that has the attachment type NIC  the utility presents the following list of  command options     HBA 2   devices pci 0 0 pcildde  5d c pcild0df e602 0  physical port     Available commands   NIC revi    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     CLI Mode  emlxadm     There are two ways to run emixadm in a CLI mode   e Device path option  e Instance option    Device Path Option    USAGE  emlxadm  lt device path gt    y   lt cmd gt   cmd_options     Run the emlxadm utility program using the device path option by typing the name of the program   followed by the full device name of the desired adapter  or a pattern string for multiple adapters    followed by a valid command and any required command arguments  In the following example  the  emlxadm utility pauses to ask if you want to continue before executing the command  To specify a full  device name  type       em
37. lxadm  devices pci le  600000 SUNW  emlxs 2 fp 0 0 devctl get state 21000020371938fa    Solaris FCA Utilities User Manual Page 8     gt S EMULEX    Information similar to the following is displayed     Found path to 1 HBA port  s    HBA port   devices pci le 6000000 SUNW  emlxs 2 fp 0 0 devetl   gt Do you wish to continue with this device  y n q    y  lt    Response required    State  PORT DEVICE LOGGED IN          If you do not want the utility to pause for verification  add a   y  option just after the device path  and the  emlxadm utility will skip the verification  For example       emlxadm  devices pci le  600000 SUNW  emlxs 2 fp 0 0 devctl  y get _state  21000020371938fa    Information similar to the following is displayed     Found path to 1 HBA port s    HBA port   devices pci le 600000 SUNW  emlxs 2 fp 0 0 devetl  State  PORT DEVICE LOGGED IN            If you want to run a command on multiple adapters  you can use a pattern string instead of a full device  path  If the entire pattern string matches any part of an adapter device path  the command executes  against that adapter  Again  in this example the emlxadm utility pauses to ask if you want to continue  before executing the command     For example     emlxadm  SUNW emlxs 2  get_num_ devs  Information similar to the following is displayed     Found path to 2 HBA port s    HBA port   devices pci le  600000 SUNW  emlxs 2 fp 0 0 devetl   gt  Do you wish to continue with this device  y n q    y  lt     Response requi
38. lxdrv only updates the system configuration for the next  boot     Example   emlxdrv gt  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  q    Exits the program  If changes were made to the driver bindings  a system reboot is usually required for  all the changes to take effect     Example     emlxdrv gt  q  Exiting       NOTE  If changes were made  then a system reboot may be required        refresh    Refreshes the host bindings and main display with the latest information     Example   FC      Alias Pres Boot Oracle emlxs elxfc lpfc Models  Driver  elxfc lpfs   7 yes yes yes LP8000S  LP9002S  SBUS   elxfc   800     yes yes yes LP8000  LP8000DC  LP9002  LP9002C  LP9002DC   1xf   900      elxfc 9 yes yes yes LP9402DC  elxfc   980     yes yes yes LP9802DC    Solaris FCA Utilities User Manual Page 40     gt S EMULEX             a Alias Pres Boot Oracle emlxs elxfc lpfc Models   wise   a00 E _ wee yes ves LP10000  LP1OOOODC   LP10000ExXDC   elxfc   d00     yes yes yes LP11000  LP11002   Sixte fe00 z E oe v  s wee LPe11000  LPel11002   LPe11004   elxfc   100 yes   yes yes yes LPe12000  LPe12002   elxfc   111   7 yes yes yes LPe12000  LPe12002   elxfc   112     yes yes yes LPe12000  LPe12002   elxfc feos   7 yes yes  yes LP21000  LP21002   elxfc   0a5     yes yes 7 2G Blade Adapt
39. m gt  get_path 1  Adapt  er   pci le 600000 SUNW  emlxs 2 1 fp 0 0    get_phy_atirs    Shows the current PHY  physical transceiver connection  attributes of the for the HBA  This command  applies to converged network adapters 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  or all    Shows the current adapter API port attributes  All of the port attributes can be displayed  or a single port  can be specified by  lt index gt  or  lt wwn gt   The total number of ports available can be seen in the  Number  of Discovered Ports  attribute displayed using the get_host_attrs command  The  lt index gt  argument is an  index into this list     Example   emlxadm gt  get_port_attrs all    Host Port Attributes     Last Change   45  fp Instance  e    Solaris FCA Utilities User Manual Page 22    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  Port  0  Attributes   Node WWN   2000002037
40. mIkxu utilities package  and the following message is displayed      lt Removing EMLXemlxu package gt     If no package is installed  a message indicates this  skip to step 7  Otherwise  you are prompted  to remove the package with the following message     Do you want to remove this package   y n   q     Enter  lt y gt   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  If you want to install another version of the emlxu utilities  package  follow the instructions provided in one of the following sections        Installing or Updating the Utilities Using the emlxu_install Script    on page 1      Installing the Utilities Package Manually    on page 4     For additional information on installing and removing packages  refer the Solaris system administration  documentation and the pkgadd 1M  and pkgrm 1M  manual pages     Solaris FCA Utilities User Manual Page 3    J      EMULEX    Installing the Utilities Package Manually    If an earlier version of the emlxu utilities package is already installed on the system and you want to  install a different version  follow the instructions in    Removing the Utilities Package Manually    on page 4   then return to this section to install the new utilities package     To install the emlxu utilities package manually   
41. m_set  lt label gt   lt val gt   msgbuf  all    get_host_attrs     lt number gt     get_port_attrs  lt index gt    get_path  lt index gt   get_vpd  boot _code  enable   get_rnid  wwpn   get_inst    get_phy_ attrs  Returns the current    q  h    hba  p    emlxadm gt     Solaris FCA Utilities User Manual    disable      devices pci 0 0 pcil0de 5d c pcil0df e602 0 2 fp 0 0     FCIO rev2       i interval      lt wwn gt      Returns the number of FC devices seen by this HBA   Returns a list of FC devices seen by this HBA    Returns the login paramters for a specified FC device   Return the host parameters   Returns the symbolic port name of a device   Sets the symbolic port name for a device   Returns the symbolic node name of a device   Sets the symbolic node name for a device   Performs an FC login to a device   Performs an FC logout to a device     Returns current SFS state of a specified devic       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   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 diag
42. mlxadm gt  diag code 0x4526  Result  CODE 0x4526   16  0x10        Note  The return status from the adapter is displayed in decimal and hexadecimal format if the  diagnostic code is valid for the adapter  No interpretation of the return status is provided        download_boot  lt filename gt     Downloads the specified boot image file to the adapter   Example   emlxadm gt  download_boot TD190A4 PRG    Image Components  REL type size 143416  DWC file  BOOT  version 03845054  1 90a4    Current  Boot  1 90a3  New  Boot  1 90a4 143416  0x23038  bytes    Are you sure you want to download this image   y or n   y  Downloading     Done     Solaris FCA Utilities User Manual Page 15    y         download_fcode  lt filename 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       EMULEX    Note  The Emulex FCA driver does not allow firmware updates to Oracle branded adapters        Example     emlxadm gt  download_fw LP10000DC S fw  Image Components  NOP type    AWC file  KERN  version f  801315  1 30a5  DWC file  SLI2  version 07831914  1 90a4  DWC prog  TEST  vers
43. n   IOCTL Version    EP Fw Version    NCSI Version    Def Extended Timeout   Model    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     gt S EMULEX    SE HBA ATTR VER 0000 0001  Emulex Corporation  TOE NIC VM FCOE_INI LRO 0  2232   0x00012345   0x00897654    0   OneConnect OCe10100   BladeEngine 2 10Gb FCoE Initiator  0x425439343138323738310000000000000000000000000000  IPv4   2 701 374 2   2 701 374 2   20 3840    2 701 374 2  0   0   A2    True   11   0   0   Ki  Operational  True   8342 8342 0 00000  0xC000   LIST MODE  0  0x19a2  0x0700  Ox10df  Oxe602    O O O O O G    Displays all of the current host adapter API attributes     Example     emlxadm gt  get_host_attrs    Hoxc    FD st Attributes     Manufacturer      Oracle Microsystems  Inc     Solaris FCA Utilities User Manual    Page 19     gt S EMULEX          Serial Number   BG43918495   Model   LP10000DC S   Model Description   EMULEX LIGHTPULSE LP10000DC
44. nc 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 or  lt numbers   i interval     Shows all or part  the last  lt number gt  of lines  of the current driver message log  and can update the  screen every  lt interval gt  seconds if desired  To stop the program from updating the screen  press   lt Cirl gt    lt C gt   If no interval is provided  the current message log is displayed with no additional updates   and the emlxadm prompt returns     Example     emlxadm gt  msgbuf 10    155130 01  1002033   B 1C35 emlxs0O  DEBUG  800  ELS sent   GA_NXT  did fffffc   00011000 00000000      155130 02  1002034   4 00C9 emlxs0O  DEBUG  801  ELS comp   GA_NXT  CT_ACC  Rsn 0  Exp 0  020113e1 21000020      155130 02  1002035   B 1C35 emlxs0O  DEBUG  800  ELS sent   GA_NXT  did fffffc     000113e1 00000000     155130 02  1002036   4 00C9 emlxsO  DEBUG  801  ELS comp   GA_NXT  CT_ACC  Rsn 0  Exp 0  020113e2 21000020                            155130 02  1002037   B 1C35 emlxs0O  DEBUG  800  ELS sent   GA_NXT  did fffffc   000113e2 00000000      155130 02  1002038   4 00C9 emlxs0O  DEBUG  801  ELS comp   GA_NXT  CT_ACC  Rsn 0  Exp 0  020113e4 21000020      155130 03  1002039   B 1C35 emlxs0O  DEBUG  800  ELS sent   GA_NXT  did fffffc   000113e4 00000000      155130 03  1002040   4 00C9 emlxs0O  DEBUG  801  ELS comp   GA_NXT  CT_ACC  Rsn 0  Exp 0  020113e8 21000020      155130 03  1002041 
45. nnsssstnnnnnnnst aeterni  8  instanco  OPTION vseacdecccsctanctacctanceanatanceanatanceanatanceanatanceananandeanatanctatatdeatas 10   USing Helpis seses siseses ienris EEEE IEEE EEEE EEEE EEEE A SARRERAN 10  Command Descriptions  emlxadm           ssssssssseeeeeesssssirrrrresssrrrrnntsssrrrrnrnnnssnt 11  Command Usage           cccccccceeeeeeeenneeeeeeeeeeececaaeeeeeeeeeseecaaeeeeeeeeeeeenenaeeeeeees 14  boot_code  enable or disable                  cccccccecceeeeeeeeeeeeeeeeeaaeeeeeeeeeeeeaaa 14   dev OJN  WW nnna n a a a E ROR OOE 14  dov to gout AWD aaan 14   dev tremove  lt WWPiik eee 15   diag  lt test  parameters  gt  or diag code  lt cmd_code  hex  gt     s    15  download_boot  lt filename gt             ss nssessnnsesnrnnssnrnrssnrnnsrnnnnsnnrnnsnrrnnennnno 15  download_fcode  lt filename gt             ccccceeecccccseeeceeceeeeeeceeeeeessaeeseeeaeeeeeees 16  download_fw  lt filename gt            cccceeeccccceeeceecaeeeceeceeeseeecueeeesaeeeeessesaanses 16   torce  CWP annann 16    o   gt   Ma 01010  McA eee eee 17   ge Rdv iSt aria sense ri tera ats aia nnn ane ene aa ene 17  QGet_AUMP_ SIZE        ieee cecceec cece eeeeeeeeeeeeeeeaaaeeeeeeeeeeeeaaaaeeeeeeseeesaaaaeeeeeeess 18   gel Gump   HM  ecesecrsech acter Aciciencianctanctanctanchenctanchanstanchanstanctanetenctandeneenees 18   Get _FCODC_FOV APEE 18   GEEN TEV ron atest e ereecneh esas ue eh exeecnehuaadenaheneetneh A EAE 18   Get Nba _attrs         cece ce cece cece cee eeeeeeeeeeeeeaaeeeeeeeeeeeeeaaaeaeee
46. nostic 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    or shows the boot code state in this HBA     the RNID information for local or specified port     Sets  Gets  the driver instance    PHY attributes for the HBA   Exits this program     Gets   CNA s only        Returns this help screen   Select another hba   Repeat previous command     Page 7     gt S EMULEX    At the bottom of the command list is an emlxadm gt  prompt  From this point  the utility is prompt driven   When the prompt is displayed  you must enter one of the commands in the list  The list is displayed  automatically only once  but you can display it again by typing  lt h gt  at the prompt  To exit the program   type  lt q gt      Some commands require additional arguments  such as a FC World Wide Port Name  WWPN  or a FC  port address  D_ID   To display the available arguments for a command  enter the command without any  arguments     For example  the command get_state requires a WWPN for the target device  If only the command  without the argument is entered  the fol
47. nstall the utilities kit using the emlxu_install script     Solaris FCA Utilities User Manual Page 1    y     gt G EMULEX    Log in as root  or su to root     Copy the utilities kit from your distribution medium into a directory  referred to here as   lt directory gt   The utilities kit is a  tar file named something similar to emlxu_kit  lt version gt    sparc tar     Change to the directory where you put the kit tar file by typing    cd  lt directory gt    Extract the emlxu_install script from the tar file by typing    tar xf emlxu_kit  lt version gt  sparc tar emlxu_install   Install the kit by typing    emlxu_install   The script removes any earlier version of the emlxu utilities package   If an earlier package is not  found  this fact is indicated  skip to step 9   The following text is displayed    lt Removing old EMLXemlxu package gt    If an old package is installed  you are prompted to remove it    Do you want to remove this package   y n   q     Enter  lt y gt   The following message is displayed    Removal of  lt EMLXemlxu gt  was successful    The script expands the utilities kit  tar file and begins installing the new package  The following  message is displayed     lt Expanding emlxu_kit  lt version gt  sparc tar gt     lt Adding new package gt    The script installs the emlxu utilities package  The package is prepared for installation and you  are prompted for confirmation by the following message    Do you want to continue with the installation of  lt EMLXemlx
48. o the messages file     log warnings   0x0   oxffffffff   oxffffffff   oxffffffff   yes   Verbose mask for warning messages to the messages file     log errors   0x0   oxffffffff   oxffffffff   oxffffffff   yes   Verbose mask for error messages to the messages file     num iocbs   128   1024   10240   1024   no   Number of outstanding IOCBs driver can queue to adapter     no  Number of unsolicited buffers the driver should allocate     network on   0   1   1   1   no   Enable IP processing     no  Enable ACKO support     topology  0  0    Solaris FCA Utilities User Manual Page 30    max   default   dynamic    desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc     min   current   max   default   dynamic   desc      gt S EMULEX    no  Select Fibre Channel topology     link speed   0   0   4   0   no   Select link speed     num nodes   2   512   512   512   no   Number of fibre channel nodes  NPorts  the driver will support     no  A count of milliseconds after which an interrupt response is generated     cr count   1   1   255   1   no   A count of I O completions after which an interrupt response is generated     assign alpa   0x0   0x0   Oxef   0x0   no   Assigns a preferred ALPA to the port  Only used in Loop topology     adisc support   0   1   2   1   yes   Sets the F
49. ogged In  Did  113e8    Solaris FCA Utilities User Manual    0x00000000     0x00000000     0x00000000     0x00000000      gt S EMULEX    0x00000000     0x00000000     0x00000000     0x00000000     Page 17    y      EMULEX         LILP  0   Hard Addr  e8  WWPN  2100002037193670  WWNN  2000002037193670    get_dump_size    Returns the adapter s firmware core dump size   Example     If there is a valid dump in the driver memory  you will see this   emlxadm gt  get_dump_size  Size  6580624  0x646990  bytes  If there is no valid dump in the driver memory  you will see this   emlxadm gt  get_dump_size  Size  0  0x0  bytes    get_dump   h   Saves firmware core dump to a file     Example     If there is no valid dump in the driver memory  you will see this   emlxadm gt  get_dump  h  No core file available   If there is a valid dump in the driver memory  you will see this   emlxadm gt  get_dump  h  Core size  6580624 bytes  files  2  TXT file  13728  DMP file  6566876    get_fcode_rev    Returns the current FCode revision of the adapter   Example     emlxadm gt  get_fcode_rev  FCODE revision  LP10000 S 1 41a3    get_fw_rev  Returns the current firmware revision of the adapter     Example     emlxadm gt  get_fw_rev  Firmware revision  LP10000DC S 1 90a3    get_hba_attrs    Returns the current control attributes for the adapter   Example     emlxadm gt  get_hba_attrs    HBA     Solaris FCA Utilities User Manual Page 18    Flash ROM Version   Manufacturer    Support Modes   SEEPROM Versio
50. pported FC4 Types   00000000  00000000   00000000  00000000    Port Active FC4 Types   00000000  00000000   00000000  00000000    Port Symbolic Name   Port Supported Speed   Port Speed   Port Max Frame Size    Fabric Name    Port  3  Attributes       0x0 bytes    0000000000000000      2000002037193670    2100002037193670    0113e8     Unknown     Unknown     Class3    00000000   00000000     00000000   00000000     00000000  00000000   00000000  00000000     SEAGATE ST39103FC    Unknown    0004      Unknown    Node WWN   Port WWN   Port Fc Id   Port Type   Port State   Port Supported COS   Port Supported FC4 Types   00000000  00000000   00000000  00000000    Port Active FC4 Types   00000000  00000000   00000000  00000000    Port Symbolic Name   Port Supported Speed   Port Speed   Port Max Frame Size    Fabric Name    get_rnid  wwpn       0x0 bytes    0000000000000000    Returns the RNID information for the local or specified port     Example     emlxadm gt  get_rnid  Offset  00 01 02 03    Solaris FCA Utilities User Manual    04 05 06 07    08 09 OA OB OC OD OF OF     gt S EMULEX    0  31 30 30 30 30 30 30 30 63 39 34 63 62 64 34 65 10000000c94cbd4e  10  00 00 00 07 OO 00 00 00 00 00 00 00 00 QT  00 00   wiseddacgeeeenwas  20  00 00 00 00 00 00 00 00 00 00 00 00 00  00  00 00 cerati ede ak as  30  00 00 00 00  Done     get_state  lt wwpn gt     Returns the current Leadville state of the specified FC device on the network   Example     emlxadm gt  get_state 21000020371938fa   
51. red     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  lt     Response required   There are 0 devices reported on this port          If you do not want the utility to pause for verification  add a   y  option just after the pattern string  and  the emlxadm utility will skip the verification  For example       emlxadm  SUNW emlxs 2   y get_num devs  Information similar to the following is displayed     Found path to 2 HBA port s    HBA port   devices pci le 600000 SUNW  emlxs 2 fp 0 0 devectl    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          Solaris FCA Utilities User Manual Page 9     gt S EMULEX    Instance option    USAGE  emlxadm  i lt N  SFS  FCT  or all gt    y   lt cmd gt   cmd_option s      Run the emlxadm utility program using the instance option by typing the name of the program  followed  by one of the options listed below  followed by a valid command and any required command arguments      lt N gt    A specific emlxs driver instance   N 1 means emlxs1  N 2 means emlxs2    SFS   All emlxs driver instances attached to the Oracle SFS interface    FCT   All emlxs driver instances attached to the Oracle COMSTAR interface   all   All emlxs driver instances     This mode of operation enables you to use the emlxadm utility as part of a scrip
52. river  oracle oo    eeeeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeteeeess 40   FOTOS A A A A A A A A A 40   set emlxs  driver_name   alias          ccc ceccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 41  setidiver  Alasiri saa GS 41   set  driver  oracle oo    eeeeeccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeetess 42   set  driver name   emulex    2 a 42    Solaris FCA Utilities User Manual Page iv    J      EMULEX    Introduction    This document provides the information needed to use the Emulex   emixadm and emlxdrv utility  programs  Emulex emlxadm and emlxdrv utility programs support the following drivers     e emlxs   Solaris inbox Fibre Channel Fibre Channel over Ethernet  FC FCoE  driver   e  elxfc   Emulex distributed FC FCoE Solaris driver  does not support Oracle branded devices   e Ipfc FC   Legacy Emulex distributed FC SD driver  does not support Oracle branded devices   e oce   Solaris inbox Network Interface Card  NIC  driver   e elxnic   Emulex distributed Solaris NIC driver    For system administrators  this document includes information about installing and uninstalling 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 also be familiar with the Emulex OneConnect UCNA  as well as Fibre Channel and  Ethernet networking     Installing the Utilities    The Emul
53. ssociated to one  driver at a time  The same relationship also applies between the oce and elxnic drivers  Only one NIC  adapter model can be associated to one NIC driver at a time     Note  The simultaneous use of the Ipfc driver and either of the emlxs or elxfc  drivers is not supported and should only be used as a step when migrating  complex configurations between drivers     If you change the driver binding configuration  the host system must be rebooted in order for the new  configuration to take effect     Modes of Operation  emlxdrv     The emlxdrv utility program can be run in two modes        Interactive  e CLI    Interactive Mode  emlxdrv     Run the emlxadrv utility program in interactive mode by typing the name of the program without any  command line arguments       emlxdrv    The emlxdrv program scans the host system and prepares a driver configuration table consisting of  bindings  associations  between the emlxs  elxfc  Ipfc  oce and elxnic NIC drivers and a list of Emulex  Fibre Channel adapter models  After the table is prepared  the utility displays the following              ae Alias Pres Boot Oracle emlxs elxfc Ilpfc Models   elxfc lpfs       yes yes yes LP8000S  LP9002S  SBUS    elxfc   800       yes yes yes LP8000  LP8000DC   elxfc   900       yes yes yes elisha ra Pegasus   LP9002DC  LP9402DC   elxfc   980        yes yes yes LP9802 LP9802DC   elxfc   a00       yes yes yes pee eee  LP10000ExXDC   elxfc Fdo0       yes yes yes LP11000  LP11002   elxfc fe
54. t or another program  capable of executing system level calls     Using Help    The emlxadm utility offers online help for the commands that you use  Type  lt em xadm help gt  at the  prompt and the CLI usage screen opens  For example    emlxadm    USAGE   oL  Runs utility in interactive mode     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   ee 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     Solaris FCA Utilities User Manual Page 10     gt E EMULEX     iall Executes command on all emlxs driver instances     Executes command on a specific elxfc driver instance    jJ lt N gt   J  Example  N 2 for elxfc2 or N 2 1 for elxfc2 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   a Executes command on a specific oce driver instance    N lt N gt     Example  N 2 for oce2 or N 5 for oce5    nall  Executes command on 
55. ting   effect with the set comamnd  Sets  thedrivertoibind to  set  driver_name  oracle   page 42  all Oracle devices   You can combine arguments      from the driver list and the device   set  driver_name  gt  emulex gt  Sets the driver to bind to page 42    Page 37       y     gt G EMULEX    Command Usage  clear  driver  all    Clears the driver bindings to all devices based on the specified driver parameter  Select one of the  following driver parameters     e all   clears all bindings to all devices for all drivers  This is the default value for this parameter   e fc  clears all bindings to all devices for Fibre Channel drivers    e nic   clears all bindings to all devices for NIC drivers    e  driver_name    clears all bindings to all devices for a specific driver     You may see the message  Cannot unload module   This indicates that you must reboot the system to  get a driver to unbind from that adapter alias  emlxdrv only updates the system configuration for the next  boot  Example     emlxadm gt  clear all    Updating lpfs  Cannot unload module  emlxs  Will be unloaded upon reboot     Updating   800  Cannot unload module  emlxs  Will be unloaded upon reboot     Updating   900  Cannot unload module  lpfc  Will be unloaded upon reboot     Updating   980  Cannot unload module  lpfc  Will be unloaded upon reboot     Updating fa0o  Cannot unload module  emlxs  Will be unloaded upon reboot     Updating fd00  Cannot unload module  emlxs  Will be unloaded upon reboot     Upd
56. 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     Present   Whether this specific type of adapter is currently present in the host system  emlxdrv  allows you to bind a driver to adapters that are not currently present in the system but that may  be present at some point in the future     Boot   Whether this specific type of adapter is currently providing connectivity to the system s  boot disk  This is important because emlxdrv does not allow you to change the driver binding to  an adapter currently providing connectivity to the boot disk  If the driver binding needs to be  changed to a boot device  the system must first be configured to boot through an adapter of  another type  This procedure is not in the scope of this document     Oracle   Whether this specific type of adapter is branded and sold directly by Oracle   emlxs   Whether the emlxs driver supports this specific type of adapter    elxfc   Whether the elxfc driver supports this specific type of adapter    lpfc   Whether 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     After the driver configuration table is a list of available
57. u gt   y n       Enter  lt y gt   The installation progress is indicated    Examine the output for any errors or warnings  If the installation is successful  the following  message is displayed near the end of the process     Installation of  lt EMLXemlxu gt  was successful     The 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 leaves a copy of the emlxu_remove script in the working directory with the original  utilities kit tar file  You can remove this script  or leave it in the directory and use it to uninstall the    emlxu utilities from your system in the future  See    Removing the Utilities Using the  emlxu_remove Script    on page 3 for more details     The emlxu utilities installation is complete  The utility package s programs are located in the   opt EMLXemIxu 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 EMLXemIxu 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 further information on installing and removing packages  refer the Solaris system administration  documentation and the pkgadd 1M  and pkgrm 1M  manual pages     So
    
Download Pdf Manuals
 
 
    
Related Search
    
Related Contents
オーキー(Aukey)取扱説明書  Clique para baixar o livro completo em  KOHLER K-14191-FL-0 Installation Guide  Conseils d`entretien Avant l`utilisation Allonger les tiges télescopiques  Acer Power F3 Owner's Manual  SANDMAN Power Management User Manual  WinCAT  VGN-CS115J/R  Spectra Professional Series IP Dome System User Manual  User`s Manual JKD Features: Precautions: Before using the scale    Copyright © All rights reserved. 
   Failed to retrieve file