Solaris SFS Driver | Emulex LP1150-F4 instruction

Solaris SFS Driver

User Manual

Last Updated June 14, 2007

Image 1

Emulex LP1150-F4 user manual Solaris SFS Driver

Contents

Solaris SFS Driver Last Updated June 14 Removing the Utilities Using the emlxuremove Script Downloading and Installing the Driver for Solaris 8 orStarting the HBAnyware Utility from the Command Line Using the HBAnyware Utility Command-Line InterfacePage 104 Introduction 131 Situations That Involve HBAnyware Using the emlxdrv Utility 124 Introduction 161 Console and Log Messages 139Use Cases 161 HBA Compatibility Compatibility Procedure Known Issues Method 1 Using the Installit Script recommended Downloading and Installing the Driver for Solaris 8 orMethod 2 Using Individual Patches To obtain and install individual patchesPage Unpacking the Utility Files Installing the FCA Utilities Emlxuinstall script is available To install the utilities kit using the emlxuinstall scriptPrerequisites Enter y. The following message is displayed Known Issues Installing the HBAnyware UtilityJRE and instructions for installation can be found at Unzip the HBAnyware package file. Type To install HBAnyware with Web Launch Log on as ‘root’ Installing the HBAnyware Utility with Web LaunchRun the install script. Type Installing or Updating the Utilities Package Manually Installing the HBAnyware Utility Security ConfiguratorCompatibility Unzip the HBAnywareSSC package file Removing the Utilities Using the emlxuremove Script To remove the emlxu utilities package Removing the Utilities Package Manually Configuration Driver Parameters Solaris SFS and lpfc Driver Parameter Cross-Reference 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 Procedure Starting the HBAnyware Security ConfiguratorStarting the HBAnyware Utility Starting HBAnyware with Web Launch Starting the HBAnyware Utility from the Command Line Changing Management ModeEnter desired management mode Press Enter Click OK Examples of Modifications Menu Bar HBAnyware Utility Window Element DefinitionsToolbar Discovery-Tree Toolbar ButtonsSort Toolbar Buttons Property Tabs Using the HBAnyware Utility Command-Line InterfaceStatus Bar Discovery-Tree Icons Out-of-Band Access Using the CLI ClientSyntax Rules SaveConfig CLI Client Command Reference VersionListHBAs Sample response PortAttrib HBAAttrib ServerAttrib PortStatParameters TargetMapping Reset Download DriverConfigAllNodeInfo Sample response for a successful download DriverParamsGlobal DriverParamsSample abbreviated response SetDriverParam PciData SetBootBios LoopMap WakeupGetBeacon Below is a sample response PostTest SetBeaconEchoTest Dump LoopbackDeleteDumpFiles SetPersistentBinding PersistentBinding RemovePersistentBinding RemoveAllPersistentBindingSample response would be BindingSupport BindingCapabilitiesSetBindingSupport HBAnyware Utility, Discovery Information Discovering HBAs HBAnyware Utility, HBA Discovery Settings Dialog Box Configuring Discovery Settings Sorting Local HBAs Only Sorting HBAsSorting by Host Name Sorting by Fabric Address Viewing Discovery Information Viewing HBA InformationDiscovery Information Field Definitions Host Information Tab Viewing Host InformationHost Information Field Definitions Driver Parameter Tab Field Definitions Host Driver Parameters TabDriver Parameter Tab Buttons Adapter Summary Field Definitions Viewing General HBA Attributes Adapter Status Area Field Definitions Adapter Details Field Definitions Viewing Detailed HBA InformationPort Attributes Field Definitions Loop Map Table Definitions Viewing Fabric Information Discovery Information Field Definitions Viewing Target InformationTarget Information Field Definitions LUN Information Field Definitions Viewing LUN Information HBAnyware Utility, Statistics Tab Viewing Port Statistics Port Statistics Field Definitions Viewing Firmware Information Enable/Disable Click to enable or disable the boot codeFirmware Field Definitions Firmware Area Target Mapping Field Definitions Viewing Target Mapping Resetting HBAs Following warning screen appears Updating Firmware HBAnyware Utility, Firmware Download Dialog Box Click Start Download Click Browse. The Firmware File Selection dialog box appears HBAnyware Utility, Batch Firmware Download Dialog Box Updating Firmware Batch Mode Solaris SFS driver is installed properly Enabling or Disabling the Bios HBAnyware Utility, Firmware Tab with Bios Disabled Setting Driver Parameters HBAnyware Utility, HBA Selected Driver Parameters Tab Setting Driver Parameters for an HBA Resetting All Default Values Setting Driver Parameters for a HostRestoring All Parameters to Their Earlier Values Restoring All Parameters to Their Earlier Values Assigning Batch Mode Parameters to HBAs Creating the Batch Mode Driver Parameters File HBAnyware Utility, Batch Driver Parameters Update Dialog Box Setting Up Persistent Binding Click the Target Mapping tab. All targets are displayed HBAnyware Utility, Add Persistent Binding Dialog Box Changing Parameters or Bindings for Solaris 8, 9 Adding New Targets Using sd.conf for Solaris 8, 9Save the file and exit No-Reboot Firmware Updates Setting Up Target/LUN Blocking Using sd.confLoading or Unloading the Driver Without Rebooting Running a Quick Test Performing Diagnostic Tests Running a Post Test Using BeaconingClick OK. a Post Test window shows Post test information Displaying PCI Registers and Wakeup Information Creating Diagnostic DumpsClick Start Dump HBAnyware Utility, Advanced Diagnostics Dialog Box Running Advanced Diagnostic Tests Running Loopback Tests HBAnyware Utility, Advanced Diagnostic Tests Warning Running End-to-End Echo Tests Click Start. The following warning window appears Saving the Log File An example of a saved log file appears below Out-of-Band SAN Management HBAnyware Utility, Add Remote Host Dialog Box Adding a Single Host HBAnyware Utility, Add Remote Hosts Window Adding a Range of Hosts Removing Hosts HBAnyware SecurityIntroduction Page Unsecure System message is displayed Security Configurator, Unsecure System MessagePage Access Control Group Tab on the MSC Access Control Groups ACG Icons Access Control Group Tab on a Non-MSC Adding a Server to the ACG Deleting a Server from the ACG Click Yes. Security is removed from all servers in the ACG Removing Security from all Servers in the ACG Generating New Security Keys Restoring the ACG to Its Last Saved Configuration Accessing a Switch ASG Icons Access Sub-Groups Creating an ASG Click New. The New Access Sub-Group dialog box is displayed ASG Creation Example Reserved Indices Examples Deleting an ASG Adding a Server to an ASG Restoring an ASG to Its Last Saved Configuration Editing an ASG Security Configurator, Edit Access Sub Group Dialog Box About Offline ASGs Backup Master Eligible Systems Backup Masters Backup Master Tab and Controls Creating a Backup Master System16 as Backup Master Reassigning a Backup Master as the New MSC from the Old MSC Click the Backup Master tab Security Configurator, Backup Master Warning Dialog Box Modes of Operation emlxadm Interactive Mode emlxadm Information similar to the following is displayed CLI Mode emlxadm # emlxadm SUNW,emlxs@2 getnumdevs Getnumdevs Command Descriptions emlxadmGetdevlist Getlogiparams wwpn Returns the FC login parameters of this HBA port ExampleGethostparams Getsympname Devlogin wwpnSetsympname string Getsymnname Getstate wwpn Devlogout wwpnDevremove wwpn Linkstatus did Getfwrev Downloadfcode filenameDownloadfw filename Downloads the specified FCode image file to the HBA Example Downloadboot filename GetbootrevGetdumpsize Forcedump Resethard Resetlink wwpn or zero for local linkForces the HBA to perform a hardware reset Example Gettopology Forces the HBA to perform a core firmware reset Example ResethardcoreDiag test parameters or diag code cmdcode hex Parmgetnum Returns the total number of configurable parameters Example Parmgetlist Returns a list of configurable parameters ExamplePage Parmset label value Parmget labelExample This example attempts to set a static parameter Gethostattrs Msgbuf all or number -i intervalDisplays all of the current host HBA API attributes Example = Seagate ST39103FC Getportattrs index, wwn or all Getpath index Displays a help menu of utility commands Example Bootcode enable or disableGetvpd Exits the utility program Example Hba Repeats the last command Example Modes of Operation emlxdrv Interactive Mode emlxdrvEmlxdrv utility program can be run in two modes Interactive CLI Mode emlxdrv Setemlxs alias Command Descriptions emlxdrvSetemlxssun Setemlxsall Setlpfcnonsun Setlpfc aliasCleardev alias Clearemlxs Clearlpfc Clearnonsun Clearsun Clearall General Situations General Situations SAN Management Workstation Does Not Access Control Groups Situations Security Configurator Situations Access Control Groups ACG HBAnyware Security Configurator Access Sub-Groups Situations Security Configuration Situations Access Sub-Groups ASG HBAnyware Security Configurator Backup Masters Situations HBAnyware Security Configurator Situations Backup MastersCannot 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 Log Message Types Introduction Message Log Example Severity LevelsSeverity Levels Following is an example of a message on the system console Miscellaneous Events Msgid 0004 ErrorMsgid 0001 Debug Msgid 0002 Notice Driver Events HBA Initialization Events Msgid 0240 Error Adapter Reset Failed Msgid 0201 Error Adapter Initialization FailedMsgid 0202 Debug Adapter Initialization Msgid 0210 Debug Adapter Transition Memory Management Events Service Level Interface SLI Events Msgid 0450 Error Iocb Invalid Msgid 0432 Debug Ring ResetMsgid 0452 Debug Iocb Error Msgid 0440 Debug Adapter Msg Node Events Mailbox Events Msgid 0602 Notice Node Create Failed Msgid 0603 Debug Node UpdatedMsgid 0610 Debug Node Destroy Msgid 0611 Debug Node Closed Link Events ELS Events General I/O Packet Events Msgid 0931 Error Packet Transport Error Msgid 0922 Notice Packet Flush TimeoutMsgid 0911 Debug TXQ Watchdog Msgid 0920 Debug Packet Flush IP Traffic Events FCP Traffic Events Solaris SFS Events Msgid 1311 Debug Echo Diagnostic Completed Msgid 1310 Warning Diagnostic ErrorMsgid 1312 Warning Echo Diagnostic Failed Msgid 1313 Debug BIU Diagnostic Completed Ioctl Events Firmware Download Events Common Transport Events Msgid 1621 Debug Unsolicited CT dropped Msgid 1630 Error Invalid CT command foundMsgid 1622 Debug CT reply Different use cases will drive different migration scenarios Use Cases Sample Script File Details Operational Differences Between lpfc and SFSStartemlxsmigration.sh Finishemlxsmigration.sh Migrating Automatically Migrating a Configuration without FC BootThings to Know Before You Migrate Limitations Migrating Manually Migrating Non-emlxs HBAs to emlxs HBAs Migrating a Configuration with FC Boot Shut down the server and get to the ok prompt For an Emulex boot HBA