background image

FCA Utilities Reference Manual

Page 1

Introduction 

This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility 
programs. For system administrators, this document includes information about the installation and 
removal of these utilities.

At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN 
Foundation Software (SFS) and should have access to standard system documentation. Anyone 
working with this product should have some familiarity with the nature and use of Fibre Channel.

Fibre Channel Overview

Fibre Channel is a general-purpose, high-throughput, low-latency interconnect. It employs serial bit 
transmission over copper media, short-wave and long-wave optical media. Cable distances may range 
up to 30 meters for copper media and up to 10 kilometers for optical media. Transmission speeds 
currently range up to 4 gigabits per second, or roughly 400 megabytes per second. Fibre Channel 

transmission protocols provide high reliability, with bit error rates less than 1 in 10

-12

. Interconnects may 

be configured as point-to-point, loop, or fabric (network switch).

The Fibre Channel specifications provide for the emulation of two traditional protocols: SCSI and IP. For 
storage, Fibre Channel provides an emulation of SCSI; this emulation is dubbed FCP, short for 

Fibre 

Channel Protocol

 – a confusing acronym, in that it refers specifically to SCSI-on-Fibre Channel rather 

than to the lower-level protocols by which Fibre Channel itself operates. Throughout this document, we 
generally refer to FCP; when we mention SCSI, we 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 document as 

IP

.

The Solaris Fibre Channel Stack

Each Fibre Channel host bus adapter (HBA) is managed by an associated device driver. A device driver 
acts as a translator between an operating system and the hardware so that the operating system's 
kernel need not know the specifics of the device it uses. A device driver contains all of the code specific 
to operating a device and provides an input/output (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. These modules consist of 
several tightly coupled pieces, including a per-port driver (FP) and a system-wide transport layer (FCTL) 
driver. The FP driver handles all per-port state and common services needed by a variety of protocols 
and the FCA drivers. The FCTL module provides consistent, system-wide access of Fibre Channel 
devices and services to upper layer protocols (ULP) and administration utilities. The point of providing a 
Fibre Channel port/transport interface is to abstract and define all services available through an FCA 
driver needed by FC-4 ULP drivers such as the SCSI driver (FCP) and the IP driver (FCIP). The FCP 
function provides access to Fibre Channel disk and tape drives. The IP function provides peer-to-peer 
networking, such as TCP or UDP, between Fibre Channel hosts.

Содержание elmxdrv

Страница 1: ...FCA Utilities Reference Manual Version 1 00m for use with the Emulex Sun LightPulse Fibre Channel Adapter Driver emlxs...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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_...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Отзывы: