Using the emlxadm Utility

The emlxadm utility is a direct user interface to the FCIO interface provided by the Sun StorEdge Solaris SFS. The FCIO interface provides a Sun common ioctl interface to the FCTL, which manages the FCA drivers for each FC HBA attached to the host system.

Modes of Operation (emlxadm)

The emlxadm utility program can be run in two modes:

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 it is started, the emlxadm program scans the host system and prepares a list of qualified HBA ports to choose from. Qualified HBA ports are devices that attach to the SUN StorEdge Solaris SFS through the FP driver. After the list is prepared, the utility displays the following information:

EMLXADM Device Management Utility, Version 1.00r

COPYRIGHT © 2004-2006 Emulex. All rights reserved.

Available HBA's:

1./devices/pci@1e,600000/SUNW,qlc@3/fp@0,0:devctl (CONNECTED)

2./devices/pci@1e,600000/SUNW,qlc@3,1/fp@0,0:devctl (NOT CONNECTED)

3./devices/pci@1e,600000/SUNW,emlxs@2/fp@0,0:devctl (CONNECTED)

4./devices/pci@1e,600000/SUNW,emlxs@2,1/fp@0,0:devctl (NOT CONNECTED)

Enter an HBA number or zero to exit:

You must choose from one of the available HBAs in the list by entering the appropriate number. In this example, if you enter 3, the utility displays the HBA device name selected and presents a list of command options:

HBA: /devices/pci@1e,600000/SUNW,emlxs@2/fp@0,0:devctl

Available commands:

[rev 2]

get_num_devs

-

Returns the number of FC devices seen by this HBA.

 

get_dev_list

-

Returns a list of FC devices seen by this HBA.

 

get_logi_params <wwpn> - Returns the login paramters for a specified FC device. get_host_params - Return the host parameters.

get_sym_pname - Returns the symbolic port name of a device.

set_sym_pname <string> - Sets the symbolic port name for a device. get_sym_nname - Returns the symbolic node name of a device. set_sym_nname <string> - Sets the symbolic node name for 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 the FC device from Leadville management. link_status <d_id> - Request link error status from a specified D_ID. get_fcode_rev - Returns the current Fcode revison of the HBA. download_fcode [filename] - Download the HBA fcode.

get_fw_rev - Returns the current firmware revison of the HBA. download_fw [filename] - Download the HBA firmware. get_boot_rev *Returns the current boot revison of the HBA. download_boot [filename] *Download the HBA boot image. get_dump_size - Returns the HBA's firmware core dump size. force_dump - Force a firmware core dump on this HBA. get_dump <-t,-b> <file> - Saves firmware core dump to a file. get_topology - Returns the current FC network topology.

Solaris SFS Driver User Manual

Page 104

Page 111
Image 111
Emulex LP1150-F4 user manual Modes of Operation emlxadm, Interactive Mode emlxadm