Solaris SFS Driver
Last Updated June 14
Downloading and Installing the Driver for Solaris 8 or
Removing the Utilities Using the emlxuremove Script
Starting the HBAnyware Utility from the Command Line
Using the HBAnyware Utility Command-Line Interface
Page
104
Using the emlxdrv Utility 124
Introduction 131 Situations That Involve HBAnyware
Introduction 161
Console and Log Messages 139
Use Cases 161
Compatibility
HBA Compatibility
Known Issues
Procedure
Downloading and Installing the Driver for Solaris 8 or
Method 1 Using the Installit Script recommended
Method 2 Using Individual Patches
To obtain and install individual patches
Page
Installing the FCA Utilities
Unpacking the Utility Files
To install the utilities kit using the emlxuinstall script
Emlxuinstall script is available
Prerequisites
Enter y. The following message is displayed
Installing the HBAnyware Utility
Known Issues
JRE 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 Launch
Run the install script. Type
Installing the HBAnyware Utility Security Configurator
Installing or Updating the Utilities Package Manually
Compatibility
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 Security Configurator
Procedure
Starting the HBAnyware Utility
Starting HBAnyware with Web Launch
Changing Management Mode
Starting the HBAnyware Utility from the Command Line
Enter desired management mode Press Enter Click OK
Examples of Modifications
Menu Bar
HBAnyware Utility Window Element Definitions
Toolbar
Discovery-Tree
Toolbar Buttons
Sort Toolbar Buttons
Using the HBAnyware Utility Command-Line Interface
Property Tabs
Status Bar
Discovery-Tree Icons
Out-of-Band Access
Using the CLI Client
Syntax Rules
CLI Client Command Reference Version
SaveConfig
ListHBAs
Sample response
HBAAttrib
PortAttrib
ServerAttrib
PortStat
Parameters
Reset
TargetMapping
DriverConfig
Download
AllNodeInfo
Sample response for a successful download
DriverParamsGlobal
DriverParams
Sample abbreviated response
SetDriverParam
SetBootBios
PciData
Wakeup
LoopMap
GetBeacon
Below is a sample response
PostTest
SetBeacon
EchoTest
Dump
Loopback
DeleteDumpFiles
PersistentBinding
SetPersistentBinding
RemovePersistentBinding
RemoveAllPersistentBinding
Sample response would be
BindingSupport
BindingCapabilities
SetBindingSupport
Discovering HBAs
HBAnyware Utility, Discovery Information
Configuring Discovery Settings
HBAnyware Utility, HBA Discovery Settings Dialog Box
Sorting HBAs
Sorting Local HBAs Only
Sorting by Host Name
Sorting by Fabric Address
Viewing Discovery Information
Viewing HBA Information
Discovery Information Field Definitions
Host Information Tab
Viewing Host Information
Host Information Field Definitions
Driver Parameter Tab Field Definitions
Host Driver Parameters Tab
Driver Parameter Tab Buttons
Viewing General HBA Attributes
Adapter Summary Field Definitions
Adapter Status Area Field Definitions
Adapter Details Field Definitions
Viewing Detailed HBA Information
Port Attributes Field Definitions
Viewing Fabric Information
Loop Map Table Definitions
Discovery Information Field Definitions
Viewing Target Information
Target Information Field Definitions
Viewing LUN Information
LUN Information Field Definitions
Viewing Port Statistics
HBAnyware Utility, Statistics Tab
Port Statistics Field Definitions
Enable/Disable Click to enable or disable the boot code
Viewing Firmware Information
Firmware Field Definitions
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
Resetting All Default Values
Setting Driver Parameters for a Host
Restoring 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
Changing Parameters or Bindings for Solaris 8, 9
Adding New Targets Using sd.conf for Solaris 8, 9
Save the file and exit
No-Reboot Firmware Updates
Setting Up Target/LUN Blocking Using sd.conf
Loading or Unloading the Driver Without Rebooting
Performing Diagnostic Tests
Running a Quick Test
Running a Post Test
Using Beaconing
Click OK. a Post Test window shows Post test information
Displaying PCI Registers and Wakeup Information
Creating Diagnostic Dumps
Click 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
Removing Hosts
HBAnyware Security
Introduction
Page
Security Configurator, Unsecure System Message
Unsecure System message is displayed
Page
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
Getnumdevs
Command Descriptions emlxadm
Getdevlist
Getlogiparams wwpn
Returns the FC login parameters of this HBA port Example
Gethostparams
Devlogin wwpn
Getsympname
Setsympname string
Getsymnname
Devlogout wwpn
Getstate wwpn
Devremove wwpn
Linkstatus did
Downloadfcode filename
Getfwrev
Downloadfw filename
Downloads the specified FCode image file to the HBA Example
Getbootrev
Downloadboot filename
Getdumpsize
Forcedump
Resetlink wwpn or zero for local link
Resethard
Forces the HBA to perform a hardware reset Example
Gettopology
Forces the HBA to perform a core firmware reset Example
Resethardcore
Diag test parameters or diag code cmdcode hex
Returns the total number of configurable parameters Example
Parmgetnum
Returns a list of configurable parameters Example
Parmgetlist
Page
Parmset label value
Parmget label
Example This example attempts to set a static parameter
Gethostattrs
Msgbuf all or number -i interval
Displays all of the current host HBA API attributes Example
Getportattrs index, wwn or all
= Seagate ST39103FC
Getpath index
Bootcode enable or disable
Displays a help menu of utility commands Example
Getvpd
Exits the utility program Example
Repeats the last command Example
Hba
Modes of Operation emlxdrv
Interactive Mode emlxdrv
Emlxdrv utility program can be run in two modes Interactive
CLI Mode emlxdrv
Command Descriptions emlxdrv
Setemlxs alias
Setemlxssun
Setemlxsall
Setlpfcnonsun
Setlpfc alias
Cleardev 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 Backup Masters Situations
HBAnyware Security Configurator Situations Backup Masters
Cannot modify the Security Configurator
Error Message Situations
Error Message Situations
Following error message is displayed when
Master Security Client Situations
Master Security Client Situations
Master Security Client Situations
Introduction
Log Message Types
Severity Levels
Message Log Example
Severity Levels
Following is an example of a message on the system console
Msgid 0004 Error
Miscellaneous Events
Msgid 0001 Debug
Msgid 0002 Notice
Driver Events
HBA Initialization Events
Msgid 0201 Error Adapter Initialization Failed
Msgid 0240 Error Adapter Reset Failed
Msgid 0202 Debug Adapter Initialization
Msgid 0210 Debug Adapter Transition
Memory Management Events
Service Level Interface SLI Events
Msgid 0432 Debug Ring Reset
Msgid 0450 Error Iocb Invalid
Msgid 0452 Debug Iocb Error
Msgid 0440 Debug Adapter Msg
Mailbox Events
Node Events
Msgid 0603 Debug Node Updated
Msgid 0602 Notice Node Create Failed
Msgid 0610 Debug Node Destroy
Msgid 0611 Debug Node Closed
Link Events
ELS Events
General I/O Packet Events
Msgid 0922 Notice Packet Flush Timeout
Msgid 0931 Error Packet Transport Error
Msgid 0911 Debug TXQ Watchdog
Msgid 0920 Debug Packet Flush
FCP Traffic Events
IP Traffic Events
Solaris SFS Events
Msgid 1310 Warning Diagnostic Error
Msgid 1311 Debug Echo Diagnostic Completed
Msgid 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 found
Msgid 1622 Debug CT reply
Use Cases
Different use cases will drive different migration scenarios
Sample Script File Details
Operational Differences Between lpfc and SFS
Startemlxsmigration.sh
Finishemlxsmigration.sh
Migrating a Configuration without FC Boot
Migrating Automatically
Things to Know Before You Migrate
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