background image

FCA Utilities Reference Manual

Page iii

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 .................................................................. 5
Removing the Utilities Package Manually ................................................................ 5
Updating the Utilities Package Manually.................................................................. 6

Using the emlxadm Utility ......................................................................7

Modes of Operation (emlxadm) ............................................................................... 7

Interactive Mode (emlxadm) .............................................................................. 7
CLI Mode (emlxadm) ......................................................................................... 8

Command Descriptions (emlxadm).......................................................................... 8

get_num_devs................................................................................................... 9
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 <wwpn> ...................................................................................... 12
link_status <d_id> ........................................................................................... 12
get_fcode_rev ................................................................................................. 12
download_fcode <filename>............................................................................ 13
get_fw_rev....................................................................................................... 13
download_fw <filename> ................................................................................. 13
get_boot_rev ................................................................................................... 13
download_boot <filename> ............................................................................. 14
get_dump_size ................................................................................................ 14
force_dump ..................................................................................................... 14
get_dump <-t filename.txt or -b filename.bin> ................................................. 14
get_topology.................................................................................................... 15
reset_link <wwpn or zero for local link>........................................................... 15
reset_hard ....................................................................................................... 15
reset_hard_core .............................................................................................. 15
diag <test [parameters]> or diag code <cmd_code (hex)> .............................. 15
ns .................................................................................................................... 16
parm_get_num ................................................................................................ 17
parm_get_list................................................................................................... 17
parm_get <label> ............................................................................................ 19
parm_set <label> <value> ............................................................................... 20
msgbuf all or <number> [-i interval] ................................................................. 20
get_host_attrs ................................................................................................. 21
get_port_attrs <index>, <wwn> or all............................................................... 21
get_path <index>............................................................................................. 24
q ...................................................................................................................... 24

Содержание 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...

Отзывы: