Manuals
/
Brands
/
Power Tools
/
Power Screwdriver
/
Emulex
/
Power Tools
/
Power Screwdriver
Emulex
LP1150-F4 user manual
1
1
175
175
Download
175 pages, 4.38 Mb
Solaris SFS Driver
User Manual
Last Updated June
14, 2007
Contents
Main
Page
Page
Page
Page
Troubleshooting .................................................................................131
Page
Installation
Compatibility
Known Issues
Minimum Driver for Firmware Installation on LPe11000 and LPe11002 HBAs
Special Circumstances for Installing Solaris SFS Driver Version 2.12 or later
Procedure 1
Procedure 2
Installing the Solaris SFS Driver
Downloading and Installing the Driver for Solaris 8 or 9
Method 1: Using the Install_it Script (recommended)
Method 2: Using Individual Patches
Downloading and Installing the Driver for Solaris 10 (Sparc, X64 and x86)
Installing the FCA Utilities and the HBAnyware Utility
Unpacking the Utility Files
Installing the FCA Utilities
Installing or Updating the FCA Utilities Using the emlxu_install Script
Page
Installing the HBAnyware Utility, Web Launch and Security Configurator
Known Issues
Installing the HBAnyware Utility
Installing the HBAnyware Utility with Web Launch
Installing the HBAnyware Utility Security Configurator
Installing or Updating the Utilities Package Manually
Compatibility
Removing the Utilities Using the emlxu_remove Script
Removing the Utilities Package Manually
Configuration
Driver Parameters
Solaris SFS Driver User Manual Page 14
Solaris SFS and lpfc Driver Parameter Cross-Reference Table
Table 1: Solaris SFS and lpfc Driver Parameter Cross-Reference
Solaris SFS Driver User Manual Page 15
Solaris SFS Driver User Manual Page 16
Solaris SFS Driver User Manual Page 17
Using the HBAnyware Utility
Starting the HBAnyware Utility
Starting HBAnyware with Web Launch
Starting the HBAnyware Security Configurator
Starting the HBAnyware Utility from the Command Line
Changing Management Mode
The HBAnyware Utility Window Element Definitions
The Menu Bar
The Toolbar
The Toolbar Buttons
Sort Toolbar Buttons
The Discovery-Tree
Discovery-Tree Icons
Property Tabs
Using the HBAnyware Utility Command-Line Interface
Using the CLI Client
Syntax Rules
Out-of-Band Access
CLI Client Command Reference Version
ListHBAs
SaveConfig
Solaris SFS Driver User Manual Page 25
HBAAttrib
Sample response:
Parameters: WWPN - The World Wide Port Name of the HBA. This HBA can be either local or remote.
PortAttrib
Sample response:
PortStat
ServerAttrib
TargetMapping
Download
AllNodeInfo
DriverConfig
DriverParams
DriverParamsGlobal
SetDriverParam
SetBootBios
PciData
Wakeup
LoopMap
GetBeacon
SetBeacon
PostTest
EchoTest
Loopback
Dump
DeleteDumpFiles
PersistentBinding
SetPersistentBinding
RemoveAllPersistentBinding
RemovePersistentBinding
BindingCapabilities
BindingSupport
SetBindingSupport
Discovering HBAs
Configuring Discovery Settings
Sorting HBAs
Sorting by Host Name
Sorting by Fabric Address
Sorting Local HBAs Only
Viewing HBA Information
Viewing Discovery Information
Discovery Information Field Definitions
Viewing Host Information
The Host Information Tab
Host Information Field Definitions
The Host Driver Parameters Tab
Driver Parameter Tab Field Definitions
Driver Parameter Tab Buttons
Viewing General HBA Attributes
Adapter Summary Field Definitions
Adapter Status Area Field Definitions
Viewing Detailed HBA Information
Adapter Details Field Definitions
Port Attributes Field Definitions
Loop Map Table Definitions
Viewing Fabric Information
Discovery Information Field Definitions
Viewing Target Information
Target Information Field Definitions
Viewing LUN Information
LUN Information Field Definitions
Viewing Port Statistics
Port Statistics Field Definitions
Viewing Firmware Information
Firmware Field Definitions
Firmware Area
Firmware Tab Buttons
Viewing Target Mapping
Target Mapping Field Definitions
Resetting HBAs
Updating Firmware
Page
Page
Updating Firmware (Batch Mode)
Enabling or Disabling the BIOS
Setting Driver Parameters
Setting Driver Parameters for an HBA
Restoring All Parameters to Their Earlier Values
Resetting All Default Values
Setting Driver Parameters for a Host
Page
Creating the Batch Mode Driver Parameters File
Assigning Batch Mode Parameters to HBAs
Setting Up Persistent Binding
Page
Page
Adding New Targets Using sd.conf for Solaris 8, 9 and 10
Changing Parameters or Bindings for Solaris 8, 9 and 10
Setting Up Target/LUN Blocking Using sd.conf
No-Reboot Firmware Updates
Loading or Unloading the Driver Without Rebooting
Performing Diagnostic Tests
Running a Quick Test
Running a POST Test
Using Beaconing
Creating Diagnostic Dumps
Displaying PCI Registers and Wakeup Information
Running Advanced Diagnostic Tests
Running Loopback Tests
Running End-to-End (ECHO) Tests
Saving the Log File
Out-of-Band SAN Management
Adding a Single Host
Adding a Range of Hosts
Removing Hosts
HBAnyware Security
Page
Page
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
Page
Removing Security from all Servers in the ACG
Generating New Security Keys
Page
Page
Access Sub-Groups
ASG Icons
Creating an ASG
Reserved Indices - Examples
Adding a Server to an ASG
Deleting an ASG
Page
Editing an ASG
About Offline ASGs
Backup Masters
Backup Master Eligible Systems
Backup Master Tab and Controls
Creating a Backup Master
Reassigning a Backup Master as the New MSC from the Old MSC
Page
Reassigning a Backup Master as the New MSC from the Backup Master
Using the emlxadm Utility
Modes of Operation (emlxadm)
Interactive Mode (emlxadm)
CLI Mode (emlxadm)
Page
Solaris SFS Driver User Manual Page 107
Command Descriptions (
get_num_devs
Returns the number of FC devices currently seen by this HBA port.
get_dev_list
Returns a list of FC devices currently seen by this HBA port.
get_logi_params <wwpn>
Returns the FC login common service parameters for a specified FC device on the network.
get_host_params
Returns the FC login parameters of this HBA port.
get_sym_pname
set_sym_pname <"string">
get_sym_nname
set_sym_nname <"string">
dev_login <wwpn>
dev_logout <wwpn>
get_state <wwpn>
dev_remove <wwpn>
link_status <d_id>
get_fcode_rev
download_fcode <filename>
get_fw_rev
download_fw <filename>
get_boot_rev
download_boot <filename>
get_dump_size
force_dump
get_dump <-t filename.txt or -b filename.bin>
get_topology
reset_link <wwpn or zero for local link>
reset_hard
reset_hard_core
diag <test [parameters]> or diag code <cmd_code (hex)>
Solaris SFS Driver User Manual Page 115
ns
Performs and returns a complete query of the fabric name server.
parm_get_num
Returns the total number of configurable parameters.
Solaris SFS Driver User Manual Page 116
parm_get_list
Returns a list of configurable parameters.
Solaris SFS Driver User Manual Page 117
Solaris SFS Driver User Manual Page 118
parm_get <label>
Gets the value of a specified parameter in the driver.
parm_set <label> <value>
Example: This example attempts to set a static parameter:
Solaris SFS Driver User Manual Page 119
msgbuf all or <number> [-i interval]
get_host_attrs
Displays all of the current host HBA API attributes.
Solaris SFS Driver User Manual Page 120
get_port_attrs <index>, <wwn> or all
Solaris SFS Driver User Manual Page 121
get_path <index>
get_vpd
boot_code [enable or disable]
q
h
Solaris SFS Driver User Manual Page 123
hba
p
Repeats the last command.
Using the emlxdrv Utility
Modes of Operation (emlxdrv)
Interactive Mode (emlxdrv)
CLI Mode (emlxdrv)
Command Descriptions (emlxdrv)
set_emlxs <alias>
set_emlxs_sun
set_emlxs_all
set_lpfc <alias>
set_lpfc_nonsun
clear_dev <alias>
clear_lpfc
clear_emlxs
clear_sun
clear_nonsun
Solaris SFS Driver User Manual Page 130
clear_all
q
Troubleshooting
Situations That Involve HBAnyware
General Situations
Solaris SFS Driver User Manual Page 132
Table 1: General Situations (Continued)
Security Configurator Situations - Access Control Groups (ACG)
Solaris SFS Driver User Manual Page 133
Table 2: Access Control Groups Situations
Table 1: General Situations (Continued)
Solaris SFS Driver User Manual Page 134
Security Configuration Situations - Access Sub-Groups (ASG)
Table 3: HBAnyware Security Configurator - Access Sub-Groups Situations
HBAnyware Security Configurator Situations - Backup Masters
Solaris SFS Driver User Manual Page 135
Table 4: HBAnyware Security Configurator - Backup Masters Situations
Cannot modify the Securit y Configurator
Table 3: HBAnyware Security Configurator - Access Sub-Groups Situations (Continued)
Error Message Situations
Solaris SFS Driver User Manual Page 136
Table 5: Error Message Situations
The following error message is displayed when deleting an ASG
Table 4: HBAnyware Security Configurator - Backup Masters Situations
Master Security Client Situations
Solaris SFS Driver User Manual Page 137
Table 6: Master Security Client Situations
Table 5: Error Message Situations
Page
Solaris SFS Driver User Manual Page 139
Console and Log Messages
Table 8 lists the types of log messages that can be logged to the system file.
Introduction
Table 8: Log Message Types
Solaris SFS Driver User Manual Page 140
Severity Levels
Message Log Example
The following is an example of a message on the system console.
The following is an example of the same message in the system message log (/var/adm/messages) file.
In the above system log message:
Miscellaneous Events
MSG_ID: 0001 Debug
MSG_ID: 0002 Notice
MSG_ID: 0003 Warning
MSG_ID: 0004 Error
Driver Events
MSG_ID: 0100 Notice: Driver Attach
MSG_ID: 0101 Error: Driver Attach Failed
MSG_ID: 0102 Debug: Driver Attach
MSG_ID: 0110 Notice: Driver Detach
HBA Initialization Events
MSG_ID: 0200 Notice: Adapter Initialization
MSG_ID: 0201 Error: Adapter Initialization Failed
MSG_ID: 0202 Debug: Adapter Initialization
MSG_ID: 0210 Debug: Adapter Transition
MSG_ID: 0220 Debug: Adapter Online
MSG_ID: 0230 Debug: Adapter Offline
Memory Management Events
MSG_ID: 0300 Debug: Memory Allocated
MSG_ID: 0301 Error: Memory Allocation Failed
MSG_ID: 0310 Error: Memory Pool Error
MSG_ID: 0311 Debug: Memory Pool Allocation Failed
Service Level Interface (SLI) Events
MSG_ID: 0400 Debug: Vital Product Data
MSG_ID: 0410 Debug: Link Attention
MSG_ID: 0411 Debug: State Change
MSG_ID: 0420 Error: Adapter Hardware Error
MSG_ID: 0432 Debug: Ring Reset
MSG_ID: 0440 Debug: Adapter Msg
MSG_ID: 0450 Error: IOCB Invalid
MSG_ID: 0451 Debug: IOCB Queue Full
MSG_ID: 0452 Debug: IOCB Error
Mailbox Events
MSG_ID: 0500 Debug: Mailbox Event
MSG_ID: 0501 Debug: Mailbox Detail
MSG_ID: 0510 Debug: Stray Mailbox Interrupt
MSG_ID: 0520 Error: Mailbox Completion Error
MSG_ID: 0602 Notice: Node Create Failed
MSG_ID: 0603 Debug: Node Updated
MSG_ID: 0610 Debug: Node Destroy
MSG_ID: 0611 Debug: Node Closed
MSG_ID: 0612 Notice: Node Missing
Link Events
MSG_ID: 0700 Debug: Link Event
MSG_ID: 0710 Notice: Link Down
MSG_ID: 0720 Notice: Link Up
MSG_ID: 0721 Notice: NPIV Link Up
ELS Events
MSG_ID: 0800 Debug: ELS Sent
MSG_ID: 0801 Debug: ELS Comp
MSG_ID: 0810 Error: Stray ELS Completion
MSG_ID: 0811 Debug: Abnormal ELS Completion
General I/O Packet Events
MSG_ID: 0900 Notice: Packet Abort
MSG_ID: 0901 Warning: Packet Abort Failed
MSG_ID: 0910 Debug: Packet Timeout
MSG_ID: 0911 Debug: Ring Watchdog
MSG_ID: 0911 Debug: TXQ Watchdog
MSG_ID: 0920 Debug: Packet Flush
MSG_ID: 0921 Debug: Packet Flushed
MSG_ID: 0922 Notice: Packet Flush Timeout
MSG_ID: 0930 Notice: Packet Transport Failed
FCP Traffic Events
MSG_ID: 1000 Debug: Stray FCP Completion
MSG_ID: 1001 Debug: FCP Completion Error
IP Traffic Events
MSG_ID: 1200 Debug: IP Detail
Solaris SFS Events
MSG_ID: 1300 Debug: SFS
MSG_ID: 1301 Debug: SFS Detail
MSG_ID: 1310 Warning: Diagnostic Error
MSG_ID: 1311 Debug: ECHO Diagnostic Completed
MSG_ID: 1312 Warning: ECHO Diagnostic Failed
MSG_ID: 1313 Debug: BIU Diagnostic Completed
MSG_ID: 1314 Error: BIU Diagnostic Failed
IOCTL Events
MSG_ID: 1400 Debug: IOCTL
MSG_ID: 1401 Debug: IOCTL Detail
MSG_ID: 1410 Debug: DFC
MSG_ID: 1411 Debug: DFC Detail
Firmware Download Events
MSG_ID: 1500 Debug: Firmware Image
MSG_ID: 1501 Debug: Firmware Image Detail
MSG_ID: 1510 Error: Bad Firmware Image
MSG_ID: 1511 Error: Firmware Image Not Compatible
Common Transport Events
MSG_ID: 1600 Debug: CT sent
MSG_ID: 1601 Debug: CT comp
MSG_ID: 1610 Error: Stray CT completion
MSG_ID: 1611 Debug: Abnormal CT completion
MSG_ID: 1621 Debug: Unsolicited CT dropped
MSG_ID: 1622 Debug: CT reply
MSG_ID: 1630 Error: Invalid CT command found
Appendix
Use Cases
Migrating from the Solaris lpfc Driver to the Solaris SFS Driver
Operational Differences Between lpfc and SFS
Sample Script File Details
start_emlxs_migration.sh
finish_emlxs_migration.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