Related Manuals for Emulex EMULEX
Summary of Contents for Emulex EMULEX
- Page 1 FCA Utilities Reference Manual Version 1.00m for use with the Emulex®-Sun LightPulse® Fibre Channel Adapter Driver (emlxs)
- Page 2 Emulex Corporation 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 or patent rights of Emulex Corporation.
-
Page 3: Table Of Contents
Table of Contents Introduction ...1 Fibre Channel Overview ... 1 The Solaris Fibre Channel Stack ... 1 Installing the Utilities ...3 Installing or Updating the Utilities Using the emlxu_install Script ... 3 Removing the Utilities Using the emlxu_remove Script... 4 Installing the Utilities Package Manually ... - Page 4 Table of Contents h ... 24 hba ... 25 p ... 25 Using the emlxdrv Utility ...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 ...
-
Page 5: Introduction
(I/O) interface to the rest of the system. The Emulex-Sun LightPulse® HBA device driver for Solaris, emlxs, is a Fibre Channel adapter (FCA) driver as specified by the Sun Fibre Channel architecture (also known as Leadville). The heart of the Sun Fibre Channel architecture consists of the Fibre Channel transport layer (FCTL) modules, which provide a common interface for various Fibre Channel adapters on a host. - Page 6 Figure 1 shows the software stack for network operations and SCSI operations from the standpoint of a Solaris host. Figure 1: The Solaris Software Stack FCA Utilities Reference Manual Page 2...
-
Page 7: Installing The Utilities
Foundation Software package and all the recommended patches as described in the Sun StorEdge SAN Foundation Software Installation Guide provided by Sun. The Emulex utility programs are provided as part of the emlxu utilities kit. You can download the emlxu utilities kit (for example, emlxu_kit-1.00x-sparc.tar for SPARC platforms or emlxu_kit-1.00x-i386.tar for x86/x64 platforms) from the Sun page of the Emulex Web site (http://www.emulex.com/ts/docoem/sun/... -
Page 8: Removing The Utilities Using The Emlxu_Remove Script
12. Examine the output for any errors or warnings. If the installation is successful, the following message is displayed near the end of the process: Installation of <EMLXemlxu> was successful. 13. The script performs some cleanup and displays the following messages: <Cleaning directory>... -
Page 9: Installing The Utilities Package Manually
Caution: Before installing the Emulex utilities package, you must first install the Sun StorEdge SAN Foundation Software package and all the recommended patches as described in the Sun StorEdge SAN Foundation Software Installation Guide provided by Sun. -
Page 10: Updating The Utilities Package Manually
2. You are prompted to confirm the removal by the following message: Do you want to remove this package? [y,n,?,q] 3. Enter y. The package is prepared for removal, and you are prompted again for confirmation: Do you want to remove this package? [y,n,?,q] 4. -
Page 11: Using The Emlxadm Utility
Qualified HBA ports are devices that attach to the SUN StorEdge SFS through the FP driver. After the list is prepared, the utility displays the following: EMLXADM Device Management Utility, Version 1.00q COPYRIGHT © 2004-2005 Emulex. All rights reserved. Available HBA's: /devices/pci@1e,600000/SUNW,qlc@3/fp@0,0:devctl (CONNECTED) -
Page 12: Cli Mode (Emlxadm)
reset_link <wwpn,0> - Resets the link of a specified FC device. reset_hard - Reset the HBA. reset_hard_core - Reset the HBA firmware core. diag <test> - Perform a diagnostic test on the HBA. ns - Performs a complete query of the fabric name server. parm_get_num - Returns the total number of configurable parameters. -
Page 13: Get_Num_Devs
get_num_devs Returns the number of FC devices currently seen by this HBA port. Example: emlxadm> get_num_devs There are 4 devices reported on this port. get_dev_list Returns a list of FC devices currently seen by this HBA port. Example: emlxadm> get_dev_list ----------------------------------------------- Device 0: Dtype: 0... - Page 14 Login Parameters: 00 00 00 00 20 20 00 00 88 00 08 00 00 ff 00 02 00 00 01 f4 21 00 00 20 37 19 38 fa 20 00 00 20 37 19 38 fa 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00...
-
Page 15: Get_Host_Params
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 Corporation" ioctl: FCIO_SET_SYM_PNAME: Operation not supported get_sym_nname Returns the symbolic FC node name of the HBA port. This operation is currently not supported by the Solaris Leadville stack. -
Page 16: Dev_Login
dev_login <wwpn> Performs an FC login to an FC device on the network, if not already logged in. Example: emlxadm> dev_login 21000020371938fa Done. dev_logout Performs an FC logout to an FC device on the network, if not already logged in. Example: emlxadm>... -
Page 17: Download_Fcode
download_fcode <filename> Downloads the specified FCode image file to the HBA. Example: emlxadm> download_fcode LP10000DC-S.fcode Image Components: REL type DWC file: BOOT: version=03841512, 1.50a2 Current: Fcode: 1.50a1 New: Fcode: 1.50a2 Are you sure you want to download this image? (y or n): y Downloading... -
Page 18: Download_Boot
emlxadm> get_boot_rev Firmware revision: LP10000DC-S 5.01a4 download_boot <filename> Downloads the specified boot image file to the HBA. Example: emlxadm> download_boot TL501A4.PRG Image Components: REL type DWC file: BOOT: version=03845054, 5.01a4 Current: Boot: 5.01a2 New: Boot: 5.01a4 Are you sure you want to download this image? (y or n): y Downloading... -
Page 19: Get_Topology
<test [parameters]> or diag code <cmd_code (hex)> Performs the specified diagnostics function or command code on the HBA port. This command provides support for the Emulex-specific tests shown below, or generic support to issue an HBA-specific diagnostic code (in hexadecimal) to any third party HBA. - Page 20 Tests: emlx_biu [pattern] emlx_echo <did> [pattern] emlx_post Parameters: pattern - 4 byte hex pattern to be used for test. (e.g. 0xA5A5A5A5) Example: emlxadm> diag emlx_biu Result: EMLX_DIAG_BIU: Operation successful. emlxadm> diag emlx_echo fffffc Result: EMLX_DIAG_ECHO: Operation successful. emlxadm> diag emlx_post Result: EMLX_DIAG_POST: Operation successful.
-
Page 21: Parm_Get_Num
----------------------------------------------------------------- TYPE: 02 PID: 0113E4 WWPN: 21000020371938a3 PORT_NAME: (SEAGATE ST39103FC WWNN: 20000020371938a3 NODE_NAME: (null) IPA: ffffffffffffffff IP_ADDR: 0.0.0.0 CLASS: 8 FC4_TYPES: 00000100,00000000,00000000,00000000,00000000,00000000,00000000,00000000 ----------------------------------------------------------------- TYPE: 02 PID: 0113E8 WWPN: 2100002037193670 PORT_NAME: (SEAGATE ST39103FC WWNN: 2000002037193670 NODE_NAME: (null) IPA: ffffffffffffffff IP_ADDR: 0.0.0.0 CLASS: 8 FC4_TYPES: 00000100,00000000,00000000,00000000,00000000,00000000,00000000,00000000... - Page 22 dynamic: yes desc: Verbose mask for error messages to the console. ----------------------------------------------------------------- label: log-notices min: 0x0 current: 0xffffffff max: 0xffffffff default: 0xffffffff dynamic: yes desc: Verbose mask for notice messages to the messages file. ----------------------------------------------------------------- label: log-warnings min: 0x0 current: 0xffffffff max: 0xffffffff default: 0xffffffff dynamic: yes...
-
Page 23: Parm_Get
dynamic: no desc: Select Fibre Channel topology ----------------------------------------------------------------- label: link-speed min: 0 current: 0 max: 4 default: 0 dynamic: no desc: Select link speed ----------------------------------------------------------------- label: num-nodes min: 2 current: 512 max: 512 default: 512 dynamic: no desc: Number of fibre channel nodes (NPorts) the driver will support. ----------------------------------------------------------------- label: cr-delay min: 0... -
Page 24: Parm_Set
Example: emlxadm> 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_set <label> <value> Sets the value of a specified parameter in the driver. Only dynamic parameters can be set. Example: This example sets a dynamic parameter: emlxadm>... -
Page 25: Get_Host_Attrs
Node WWN Port WWN FCA Utilities Reference Manual DEBUG: 801: ELS comp. = Emulex = BG42434343 = LP10000DC-S = EMULEX LIGHTPULSE LP10000DC-S 2GB PCI-X FIBRE = 20000000C9409ED5 = none = 1001206d = 2.00j.t4 (2005.01.18.16.38) = 1.50a2 = 1.90a4 = 10df = Emulex-Sun s10-64 sparc v2.00j.t4... - Page 26 Port Fc Id Port Type Port State Port Supported COS 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, 00, 00, 00, 00, 00,...
- Page 27 Port[2] Attributes: Node WWN Port WWN Port Fc Id Port Type Port State Port Supported COS 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, 00, 00, 00, 00, 00,...
-
Page 28: Get_Path
Fabric Name get_path <index> Displays the current Solaris device path for a specified HBA port. The total number of ports available can be seen in the "Number of HBA ports" attribute displayed using the get_host_attrs command. The <index> argument is an index into this list. Example: emlxadm>... -
Page 29: Hba
parm_set <label> <val> - Sets the value of a specified parameter in the driver. msgbuf all or <number> [-i interval] - Returns the driver's internal message log. get_host_attrs - Returns the host adapter and port attributes. get_port_attrs <index>, <wwn> or all - Returns the port attributes. get_path <index>... -
Page 30: Using The Emlxdrv Utility
Channel) driver and the Emulex lpfc (traditional non-Leadville Fibre Channel) driver to the various models of Emulex Fibre Channel HBAs. This allows both drivers to coexist in the same host and attach to mutually exclusive Emulex Fibre Channel HBA models. In other words, the emlxs driver can be configured to attach and operate one set of HBA models, while the lpfc driver can be configured to attach and operate a different set of HBA models. -
Page 31: Cli Mode (Emlxdrv)
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. -
Page 32: Command Descriptions (Emlxdrv)
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. For a detailed explanation of each command and its arguments, Command Descriptions (emlxdrv) Command Descriptions (emlxdrv) This section provides a list of commands that can be issued with the emlxdrv utility program. -
Page 33: Set_Lpfc
Updating fe00 ... Updating fc00 ... Done. set_lpfc <alias> Sets the lpfc driver to bind to the specified devices. You must specify one of the valid 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. -
Page 34: Clear_Lpfc
clear_lpfc Clears all lpfc driver bindings. 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>... -
Page 35: Clear_All
Will be unloaded upon reboot. Updating f800 ... Cannot unload module: emlxs Will be unloaded upon reboot. Updating f900 ... Cannot unload module: lpfc Will be unloaded upon reboot. Updating f980 ... Cannot unload module: lpfc Will be unloaded upon reboot. Updating fa00 ... - Page 36 Done. 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> Exiting... NOTE: If changes were made, then a system reboot may be required. FCA Utilities Reference Manual Page 32...
Need help?
Do you have a question about the EMULEX and is the answer not in the manual?
Questions and answers