Emulex LP1150-F4 Installation

Solaris SFS Driver User Manual Page 1

Installation

Introduction

Compatibility

The StorEdge SAN Foundation Software (SFS) driver and utilities support the following operating systems:

• Solaris 8 SPARC

• Solaris 9 SPARC

• Solaris 10 SPARC

• Solaris 10 x64 and x86

The following table specifies the host bus adapters (HBAs) supported by the Solaris SFS driver and the

Emulex Fibre Channel Adapter Utilities (FCA Utilities).

* Special driver and firmware installation considerations may apply. See the Known Issues sec-

tion of this manual for more information.

** Special firmware installation considerations apply. See Updating Firmware on page 55 for more

information.

Table 1: HBA Compatibility

FCA Utilities

HBA Solaris SFS Driver HBAnyware Utility emlxadm emlxdrv

SG-XPCI1FC-EM4-Z** XXXN/A

SG-XPCI2FC-EM4-Z** XXXN/A

SG-XPCIE1FC-EM4** XXXN/A

SG-XPCIE2FC-EM4** XXXN/A

SG-XPCI1FC-EM2** XXXN/A

SG-XPCI2FC-EM2** XXXN/A

LP11002 XXXX

LP11000 XXXX

LPe11002* XXXX

LPe11000* XXXX

LP10000ExDC XXXX

LP10000DC XXXX

LP10000 XXXX

LP9802 XXXX

LP9002DC XXXX

LP9002L XXXX

LP9002S XXXX

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