Command Descriptions emlxadm, Getnumdevs | Emulex LP1150-F4 guide

Command Descriptions (emlxadm)

This section provides a list of commands and descriptions that can be issued with the emlxadm utility.

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

FC4_type[proto]: 0x00000100, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000

State: Logged_In D_id: 113e1 LILP: 0

Hard Addr: e1

WWPN: 21000020371938fa

WWNN: 20000020371938fa

-----------------------------------------------

Device 1:

Dtype: 0

FC4_type[proto]: 0x00000100, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000

State: Logged_In D_id: 113e2 LILP: 0

Hard Addr: e2

WWPN: 21000020371939a2

WWNN: 20000020371939a2

-----------------------------------------------

Device 2:

Dtype: 0

FC4_type[proto]: 0x00000100, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000

State: Logged_In D_id: 113e4 LILP: 0

Hard Addr: e4

WWPN: 21000020371938a3

WWNN: 20000020371938a3

-----------------------------------------------

Device 3:

Dtype: 0

FC4_type[proto]: 0x00000100, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x00000000

State: Logged_In D_id: 113e8 LILP: 0

Hard Addr: e8

WWPN: 2100002037193670

WWNN: 2000002037193670

Solaris SFS Driver User Manual

Page 107

Image 114

Emulex LP1150-F4 user manual Command Descriptions emlxadm, Getnumdevs, Getdevlist

Contents

Solaris SFS Driver Last Updated June 14 Starting the HBAnyware Utility from the Command Line Downloading and Installing the Driver for Solaris 8 orRemoving the Utilities Using the emlxuremove Script Using the HBAnyware Utility Command-Line InterfacePage 104 Using the emlxdrv Utility 124 Introduction 131 Situations That Involve HBAnyware Console and Log Messages 139 Introduction 161Use Cases 161 Compatibility HBA Compatibility Known Issues Procedure Method 2 Using Individual Patches Downloading and Installing the Driver for Solaris 8 orMethod 1 Using the Installit Script recommended To obtain and install individual patchesPage Installing the FCA Utilities Unpacking the Utility Files Prerequisites To install the utilities kit using the emlxuinstall scriptEmlxuinstall script is available Enter y. The following message is displayed JRE and instructions for installation can be found at Installing the HBAnyware UtilityKnown Issues Unzip the HBAnyware package file. Type Installing the HBAnyware Utility with Web Launch To install HBAnyware with Web Launch Log on as ‘root’Run the install script. Type Compatibility Installing the HBAnyware Utility Security ConfiguratorInstalling or Updating the Utilities Package Manually Unzip the HBAnywareSSC package file Removing the Utilities Using the emlxuremove Script Removing the Utilities Package Manually To remove the emlxu utilities package Configuration Driver Parameters Solaris SFS and lpfc Driver Parameter Cross-Reference Table Solaris SFS and lpfc Driver Parameter Cross-Reference Solaris SFS and lpfc Driver Parameter Cross-Reference Solaris SFS and lpfc Driver Parameter Cross-Reference Solaris SFS and lpfc Driver Parameter Cross-Reference Starting the HBAnyware Utility Starting the HBAnyware Security ConfiguratorProcedure Starting HBAnyware with Web Launch Enter desired management mode Press Enter Click OK Changing Management ModeStarting the HBAnyware Utility from the Command Line Examples of Modifications HBAnyware Utility Window Element Definitions Menu BarToolbar Toolbar Buttons Discovery-TreeSort Toolbar Buttons Status Bar Using the HBAnyware Utility Command-Line InterfaceProperty Tabs Discovery-Tree Icons Using the CLI Client Out-of-Band AccessSyntax Rules ListHBAs CLI Client Command Reference VersionSaveConfig Sample response HBAAttrib PortAttrib PortStat ServerAttribParameters Reset TargetMapping AllNodeInfo DriverConfigDownload Sample response for a successful download DriverParams DriverParamsGlobalSample abbreviated response SetDriverParam SetBootBios PciData GetBeacon WakeupLoopMap Below is a sample response SetBeacon PostTestEchoTest Loopback DumpDeleteDumpFiles PersistentBinding SetPersistentBinding RemoveAllPersistentBinding RemovePersistentBindingSample response would be BindingCapabilities BindingSupportSetBindingSupport Discovering HBAs HBAnyware Utility, Discovery Information Configuring Discovery Settings HBAnyware Utility, HBA Discovery Settings Dialog Box Sorting by Host Name Sorting HBAsSorting Local HBAs Only Sorting by Fabric Address Viewing HBA Information Viewing Discovery InformationDiscovery Information Field Definitions Viewing Host Information Host Information TabHost Information Field Definitions Host Driver Parameters Tab Driver Parameter Tab Field DefinitionsDriver Parameter Tab Buttons Viewing General HBA Attributes Adapter Summary Field Definitions Adapter Status Area Field Definitions Viewing Detailed HBA Information Adapter Details Field DefinitionsPort Attributes Field Definitions Viewing Fabric Information Loop Map Table Definitions Viewing Target Information Discovery Information Field DefinitionsTarget Information Field Definitions Viewing LUN Information LUN Information Field Definitions Viewing Port Statistics HBAnyware Utility, Statistics Tab Port Statistics Field Definitions Firmware Field Definitions Enable/Disable Click to enable or disable the boot codeViewing Firmware Information Firmware Area Viewing Target Mapping Target Mapping Field Definitions Resetting HBAs Updating Firmware Following warning screen appears HBAnyware Utility, Firmware Download Dialog Box Click Browse. The Firmware File Selection dialog box appears Click Start Download Updating Firmware Batch Mode HBAnyware Utility, Batch Firmware Download Dialog Box Enabling or Disabling the Bios Solaris SFS driver is installed properly Setting Driver Parameters HBAnyware Utility, Firmware Tab with Bios Disabled Setting Driver Parameters for an HBA HBAnyware Utility, HBA Selected Driver Parameters Tab Setting Driver Parameters for a Host Resetting All Default ValuesRestoring All Parameters to Their Earlier Values Restoring All Parameters to Their Earlier Values Creating the Batch Mode Driver Parameters File Assigning Batch Mode Parameters to HBAs Setting Up Persistent Binding HBAnyware Utility, Batch Driver Parameters Update Dialog Box Click the Target Mapping tab. All targets are displayed HBAnyware Utility, Add Persistent Binding Dialog Box Adding New Targets Using sd.conf for Solaris 8, 9 Changing Parameters or Bindings for Solaris 8, 9Save the file and exit Setting Up Target/LUN Blocking Using sd.conf No-Reboot Firmware UpdatesLoading or Unloading the Driver Without Rebooting Performing Diagnostic Tests Running a Quick Test Using Beaconing Running a Post TestClick OK. a Post Test window shows Post test information Creating Diagnostic Dumps Displaying PCI Registers and Wakeup InformationClick Start Dump Running Advanced Diagnostic Tests HBAnyware Utility, Advanced Diagnostics Dialog Box HBAnyware Utility, Advanced Diagnostic Tests Warning Running Loopback Tests Running End-to-End Echo Tests Saving the Log File Click Start. The following warning window appears Out-of-Band SAN Management An example of a saved log file appears below Adding a Single Host HBAnyware Utility, Add Remote Host Dialog Box Adding a Range of Hosts HBAnyware Utility, Add Remote Hosts Window HBAnyware Security Removing HostsIntroduction Page Security Configurator, Unsecure System Message Unsecure System message is displayedPage Access Control Groups Access Control Group Tab on the MSC Access Control Group Tab on a Non-MSC ACG Icons Adding a Server to the ACG Deleting a Server from the ACG Removing Security from all Servers in the ACG Click Yes. Security is removed from all servers in the ACG Generating New Security Keys Restoring the ACG to Its Last Saved Configuration Accessing a Switch Access Sub-Groups ASG Icons Click New. The New Access Sub-Group dialog box is displayed Creating an ASG Reserved Indices Examples ASG Creation Example Adding a Server to an ASG Deleting an ASG Restoring an ASG to Its Last Saved Configuration Security Configurator, Edit Access Sub Group Dialog Box Editing an ASG About Offline ASGs Backup Masters Backup Master Eligible Systems Creating a Backup Master Backup Master Tab and Controls Reassigning a Backup Master as the New MSC from the Old MSC System16 as Backup Master Click the Backup Master tab Security Configurator, Backup Master Warning Dialog Box Interactive Mode emlxadm Modes of Operation emlxadm CLI Mode emlxadm Information similar to the following is displayed # emlxadm SUNW,emlxs@2 getnumdevs Command Descriptions emlxadm GetnumdevsGetdevlist Returns the FC login parameters of this HBA port Example Getlogiparams wwpnGethostparams Setsympname string Devlogin wwpnGetsympname Getsymnname Devremove wwpn Devlogout wwpnGetstate wwpn Linkstatus did Downloadfw filename Downloadfcode filenameGetfwrev Downloads the specified FCode image file to the HBA Example Getdumpsize GetbootrevDownloadboot filename Forcedump Forces the HBA to perform a hardware reset Example Resetlink wwpn or zero for local linkResethard Gettopology Resethardcore Forces the HBA to perform a core firmware reset ExampleDiag test parameters or diag code cmdcode hex Returns the total number of configurable parameters Example Parmgetnum Returns a list of configurable parameters Example ParmgetlistPage Parmget label Parmset label valueExample This example attempts to set a static parameter Msgbuf all or number -i interval GethostattrsDisplays all of the current host HBA API attributes Example Getportattrs index, wwn or all = Seagate ST39103FC Getpath index Getvpd Bootcode enable or disableDisplays a help menu of utility commands Example Exits the utility program Example Repeats the last command Example Hba Interactive Mode emlxdrv Modes of Operation emlxdrvEmlxdrv utility program can be run in two modes Interactive CLI Mode emlxdrv Setemlxssun Command Descriptions emlxdrvSetemlxs alias Setemlxsall Setlpfc alias SetlpfcnonsunCleardev alias Clearlpfc Clearemlxs Clearsun Clearnonsun Clearall General Situations General Situations SAN Management Workstation Does Not Security Configurator Situations Access Control Groups ACG Access Control Groups Situations Security Configuration Situations Access Sub-Groups ASG HBAnyware Security Configurator Access Sub-Groups Situations HBAnyware Security Configurator Situations Backup Masters HBAnyware Security Configurator Backup Masters SituationsCannot modify the Security Configurator Error Message Situations Error Message SituationsFollowing error message is displayed when Master Security Client Situations Master Security Client Situations Master Security Client Situations Introduction Log Message Types Severity Levels Severity LevelsMessage Log Example Following is an example of a message on the system console Msgid 0001 Debug Msgid 0004 ErrorMiscellaneous Events Msgid 0002 Notice Driver Events HBA Initialization Events Msgid 0202 Debug Adapter Initialization Msgid 0201 Error Adapter Initialization FailedMsgid 0240 Error Adapter Reset Failed Msgid 0210 Debug Adapter Transition Memory Management Events Service Level Interface SLI Events Msgid 0452 Debug Iocb Error Msgid 0432 Debug Ring ResetMsgid 0450 Error Iocb Invalid Msgid 0440 Debug Adapter Msg Mailbox Events Node Events Msgid 0610 Debug Node Destroy Msgid 0603 Debug Node UpdatedMsgid 0602 Notice Node Create Failed Msgid 0611 Debug Node Closed Link Events ELS Events General I/O Packet Events Msgid 0911 Debug TXQ Watchdog Msgid 0922 Notice Packet Flush TimeoutMsgid 0931 Error Packet Transport Error Msgid 0920 Debug Packet Flush FCP Traffic Events IP Traffic Events Solaris SFS Events Msgid 1312 Warning Echo Diagnostic Failed Msgid 1310 Warning Diagnostic ErrorMsgid 1311 Debug Echo Diagnostic Completed Msgid 1313 Debug BIU Diagnostic Completed Ioctl Events Firmware Download Events Common Transport Events Msgid 1630 Error Invalid CT command found Msgid 1621 Debug Unsolicited CT droppedMsgid 1622 Debug CT reply Use Cases Different use cases will drive different migration scenarios Operational Differences Between lpfc and SFS Sample Script File DetailsStartemlxsmigration.sh Finishemlxsmigration.sh Things to Know Before You Migrate Migrating a Configuration without FC BootMigrating Automatically Limitations Migrating Manually Migrating a Configuration with FC Boot Migrating Non-emlxs HBAs to emlxs HBAs For an Emulex boot HBA Shut down the server and get to the ok prompt