background image

FCA Utilities Reference Manual

Page 27

The display comprises three parts: the current driver configuration table, a list of available commands 
and the emlxdrv prompt.

The driver configuration table contains the following columns of data:

Driver: Indicates which driver (emlxs, lpfc or "-" if none ) is currently configured to bind or attach 
to a specific adapter alias.

Alias: Indicates the specific adapter alias associated with a set of Emulex HBA models. Driver 
bindings can be made only with a specific adapter alias and not with a specific adapter model.

Present: Indicates whether this specific type of adapter is currently present in the host system. 
Emlxdrv allows you to bind a driver to adapters that are not currently present in the system but 
that may be present at some point in the future.

Boot: Indicates whether this specific type of adapter is currently providing 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.

Sun: Indicates whether this specific type of adapter is branded and sold directly by Sun 
Microsystems.

Models: Provides a list of Emulex HBA models that are identified by a common adapter alias. 
Driver bindings can be made only with a specific adapter alias and not with a specific adapter 
model.

After the driver configuration table is a list of available commands. For a detailed explanation of each 
command and its arguments, see 

Command Descriptions (emlxdrv)

 on page 28.

Below the command list is an 

emlxdrv>

 prompt. From this point, the utility is prompt driven. When the 

prompt is displayed, you must enter one of the commands in the list. The current driver configuration 
table and the available command list are displayed automatically after each command is issued.

Some commands require an additional <alias> argument. You must specify one of the valid adapter 
aliases listed in the current driver configuration table. Each alias is shared by multiple adapter models. 
Driver bindings can be made only with an adapter alias and not with a specific adapter model.

To exit the program, enter 

q

CLI Mode (emlxdrv)

The emlxdrv utility program can be run in CLI mode by typing the name of the program followed by a 
valid command and any required command arguments. For example, you can update the a device 
binding by entering all the information on one line at the operating system prompt:

# emlxdrv set_emlxs f980

Updating f980 ...
Done.

 Driver Alias Present Boot Sun Models
-----------------------------------------------------------------
 emlxs  lpfs  no      no   no  LP8000S and LP9002S (SBUS)
 -      f800  no      no   no  LP8000 and LP8000DC
 lpfc   f900  yes     no   no  LP9002, LP9002C, LP9002DC, and LP9402DC
 lpfc   f980  no      no   no  LP9802 and LP9802DC
 emlxs  fa00  yes     no   no  LP10000, LP10000DC and LP10000ExDC
 emlxs  fd00  no      no   no  LP11000 and LP11002
 emlxs  fe00  no      no   no  LPe11000 and LPe11002
 emlxs  f0a5  no      no   no  2G Blade Adapter (emlxs only)
 emlxs  fc00  yes     no   yes LP10000-S and LP10000DC-S
 emlxs  fc20  no      no   yes LPe11000-S and LPe11002-S

Summary of Contents for elmxdrv

Page 1: ...FCA Utilities Reference Manual Version 1 00m for use with the Emulex Sun LightPulse Fibre Channel Adapter Driver emlxs...

Page 2: ...FibreSpy HBAnyware InSpeed MultiPulse SLI and SBOD are trademarks of Emulex Corporation All other brand or product names referenced herein are trademarks or registered trademarks of their respective c...

Page 3: ...get_dev_list 9 get_logi_params wwpn 9 get_host_params 11 get_sym_pname 11 set_sym_pname string 11 get_sym_nname 11 set_sym_nname string 11 dev_login wwpn 12 dev_logout 12 get_state wwpn 12 dev_remove...

Page 4: ...26 Modes of Operation emlxdrv 26 Interactive Mode emlxdrv 26 CLI Mode emlxdrv 27 Command Descriptions emlxdrv 28 set_emlxs alias 28 set_emlxs_sun 28 set_emlxs_all 28 set_lpfc alias 29 set_lpfc_nonsun...

Page 5: ...e are referring to the particular SCSI properties within FCP or to the original SCSI protocol For networking Fibre Channel provides an encapsulation of IP Internet Protocol referred to in this documen...

Page 6: ...Software Stack 6eea XVi dc 6eea XVi dc ZgcZa ZgcZa I8E E BdYjaZ 9AE BdYjaZ HdaVg h HigZVbh HiVX HE6G8 hidgV Z H8H Yg kZg hhY 8 E JAE 9g kZg 8E JAE 9g kZg 8 IgVchedgi AVnZg 8IA 9g kZg 8 Edgi E 9g kZg...

Page 7: ...rred to here as directory The utilities kit is a tar file named something similar to emlxu_kit 1 00x sparc tar 3 Change to the directory where you put the kit tar file by typing cd directory 4 Extract...

Page 8: ...ove script If you do not have the emlxu_remove script and you do not have the original emlxu utilities kit tar file you must uninstall the emlxu package manually follow the instructions in Removing th...

Page 9: ...by typing tar xvf emlxu_kit 1 00x sparc tar 5 install the EMLXemlxu utilities package by typing pkgadd d EMLXemlxu 6 The package is prepared for installation and you are prompted to confirm the insta...

Page 10: ...uccessful The utilities package has been removed For additional information on installing and removing packages see the Solaris system administration documentation and the pkgadd 1M and pkgrm 1M manua...

Page 11: ...ailable HBAs in the list by entering the appropriate number In this example if you enter 2 the utility displays the HBA device name selected and presents a list of command options HBA devices pci 1e 6...

Page 12: ...ter q Some commands require additional arguments such as a Fibre Channel World Wide Port Name WWPN or a Fibre Channel port address D_ID To display the available arguments for a command enter the comma...

Page 13: ...0371938fa Device 1 Dtype 0 FC4_type proto 0x0100 0 0 0 0 0 0 0 State PORT_DEVICE_LOGGED_IN D_id 113e2 LILP 0 Hard Addr e2 WWPN 21000020371939a2 WWNN 20000020371939a2 Device 2 Dtype 0 FC4_type proto 0x...

Page 14: ...2 00 00 01 f4 21 00 00 20 37 19 38 fa 20 00 00 20 37 19 38 fa 00 00 00 00 00 00 00 00 00 00 00 00 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...

Page 15: ...sym_pname string Sets the symbolic FC port name of the HBA to the string provided This operation is currently not supported by the Solaris Leadville stack Example emlxadm set_sym_pname Emulex Corporat...

Page 16: ...PORT_DEVICE_LOGGED_IN dev_remove wwpn Removes the specified FC device from Leadville management link_status d_id Requests and returns the current link error status from the FC device specified by the...

Page 17: ...ple emlxadm download_fw LP10000DC S fw Image Components NOP type AWC file KERN version ff801315 1 30a5 DWC file SLI2 version 07831914 1 90a4 DWC prog TEST version 00f51010 1 00a0 DWC prog STUB version...

Page 18: ...e dump buffer Example emlxadm force_dump Done get_dump t filename txt or b filename bin Returns a copy of the HBA s firmware core dump buffer to the specified file in the specified text t or binary b...

Page 19: ...e7 e8 e9 ea eb ec ed ee ef 000000f0 f0 f1 f2 f3 f4 f5 f6 f7 f8 f9 fa fb fc fd fe ff 00000100 get_topology Returns the FC network topology of the HBA port Example emlxadm get_topology Topology PRIVATE_...

Page 20: ...16 0x10 ns Performs and returns a complete query of the fabric name server Example emlxadm ns Nameserver TYPE 02 PID 0113E1 WWPN 21000020371938fa PORT_NAME SEAGATE ST39103FC 0004 WWNN 20000020371938fa...

Page 21: ...0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 parm_get_num Returns the total number of configurable parameters Example emlxadm parm_get_num Result There are 18 configurable paramete...

Page 22: ...g errors min 0x0 current 0xffffffff max 0xffffffff default 0xffffffff dynamic yes desc Verbose mask for error messages to the messages file label num iocbs min 128 current 1024 max 10240 default 1024...

Page 23: ...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...

Page 24: ...nterval seconds if desired To stop the program from updating the screen press Ctrl C to break If no interval is provided the current message log is displayed with no additional updates and the emlxadm...

Page 25: ...0 Port Type Nport Port State Online Port Supported COS Class 3 Port Supported Fc4 Types 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 Port Active Fc4...

Page 26: ...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 Port Active Fc4 Types 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...

Page 27: ...rt Supported COS Unknown Port Supported Fc4 Types 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 Port Active Fc4 Types 00 00 01 20 00 00 00 00 00 00 00...

Page 28: ...a device dev_login wwpn Performs an FC login to a device dev_logout wwpn Performs an FC logout to a device get_state wwpn Returns current Leadville state of a specified device dev_remove wwpn Remove...

Page 29: ...revious command hba Allows you to select another HBA to interface with This prevents you from having to exit and reenter the program Example emlxadm hba Available HBA s 1 devices pci 1e 600000 SUNW ql...

Page 30: ...e consisting of bindings associations between the emlxs and lpfc drivers and a list of Emulex Fibre Channel HBA models After the table is prepared the utility displays the following EMLXDRV Driver Man...

Page 31: ...pecific adapter alias and not with a specific adapter model After the driver configuration table is a list of available commands For a detailed explanation of each command and its arguments see Comman...

Page 32: ...ly 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 a...

Page 33: ...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 s...

Page 34: ...iguration for the next boot Example emlxdrv clear_emlxs Cannot unload module emlxs Will be unloaded upon reboot Updating fc00 Cannot unload module emlxs Will be unloaded upon reboot Done clear_sun Cle...

Page 35: ...annot 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 cle...

Page 36: ...Done q Exits the program If changes were made to the driver bindings a system reboot is usually required in order for all the changes to take effect Example emlxdrv q Exiting NOTE If changes were mad...

Reviews: