Getsympname, Setsympname string, Getsymnname | Emulex LP1150-F4

get_sym_pname

Returns the symbolic FC port name of the HBA port.

Note: This operation is currently not supported by the Solaris Leadville stack.

Example:

emlxadm> get_sym_pname

ioctl: FCIO_GET_SYM_PNAME: Operation not supported

set_sym_pname <"string">

Sets the symbolic FC port name of the HBA to the string provided.

Note: This operation is currently not supported by the Solaris Leadville stack.

Example:

emlxadm> set_sym_pname "Emulex Corporation"

ioctl: FCIO_SET_SYM_PNAME: Operation not supported

get_sym_nname

Returns the symbolic FC node name of the HBA port.

Note: This operation is currently not supported by the Solaris Leadville stack.

Example:

emlxadm> get_sym_nname

ioctl: FCIO_GET_SYM_NNAME: Operation not supported

set_sym_nname <"string">

Sets the symbolic FC node name of the HBA to the string provided.

Note: This operation is currently not supported by the Solaris Leadville stack.

Example:

emlxadm> set_sym_nname "Emulex Corporation"

ioctl: FCIO_SET_SYM_NNAME: Operation not supported

dev_login <wwpn>

Performs an FC login to an FC device on the network, if not already logged in. Example:

emlxadm> dev_login 21000020371938fa

Done.

Solaris SFS Driver User Manual

Page 109

Image 116

Emulex LP1150-F4 user manual Getsympname, Setsympname string, Getsymnname, Setsymnname string, Devlogin wwpn

Contents

Solaris SFS Driver Last Updated June 14 Downloading and Installing the Driver for Solaris 8 or Removing the Utilities Using the emlxuremove ScriptStarting the HBAnyware Utility from the Command Line Using the HBAnyware Utility Command-Line InterfacePage 104 Using the emlxdrv Utility 124 Introduction 131 Situations That Involve HBAnyware Use Cases 161 Console and Log Messages 139Introduction 161 Compatibility HBA Compatibility Known Issues Procedure Downloading and Installing the Driver for Solaris 8 or Method 1 Using the Installit Script recommendedMethod 2 Using Individual Patches To obtain and install individual patchesPage Installing the FCA Utilities Unpacking the Utility Files To install the utilities kit using the emlxuinstall script Emlxuinstall script is availablePrerequisites Enter y. The following message is displayed Installing the HBAnyware Utility Known IssuesJRE and instructions for installation can be found at Unzip the HBAnyware package file. Type Run the install script. Type Installing the HBAnyware Utility with Web LaunchTo install HBAnyware with Web Launch Log on as ‘root’ Installing the HBAnyware Utility Security Configurator Installing or Updating the Utilities Package ManuallyCompatibility 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 ProcedureStarting the HBAnyware Utility Starting HBAnyware with Web Launch Changing Management Mode Starting the HBAnyware Utility from the Command LineEnter desired management mode Press Enter Click OK Examples of Modifications Toolbar HBAnyware Utility Window Element DefinitionsMenu Bar Sort Toolbar Buttons Toolbar ButtonsDiscovery-Tree Using the HBAnyware Utility Command-Line Interface Property TabsStatus Bar Discovery-Tree Icons Syntax Rules Using the CLI ClientOut-of-Band Access CLI Client Command Reference Version SaveConfigListHBAs Sample response HBAAttrib PortAttrib Parameters PortStatServerAttrib Reset TargetMapping DriverConfig DownloadAllNodeInfo Sample response for a successful download Sample abbreviated response DriverParamsDriverParamsGlobal SetDriverParam SetBootBios PciData Wakeup LoopMapGetBeacon Below is a sample response EchoTest SetBeaconPostTest DeleteDumpFiles LoopbackDump PersistentBinding SetPersistentBinding Sample response would be RemoveAllPersistentBindingRemovePersistentBinding SetBindingSupport BindingCapabilitiesBindingSupport Discovering HBAs HBAnyware Utility, Discovery Information Configuring Discovery Settings HBAnyware Utility, HBA Discovery Settings Dialog Box Sorting HBAs Sorting Local HBAs OnlySorting by Host Name Sorting by Fabric Address Discovery Information Field Definitions Viewing HBA InformationViewing Discovery Information Host Information Field Definitions Viewing Host InformationHost Information Tab Driver Parameter Tab Buttons Host Driver Parameters TabDriver Parameter Tab Field Definitions Viewing General HBA Attributes Adapter Summary Field Definitions Adapter Status Area Field Definitions Port Attributes Field Definitions Viewing Detailed HBA InformationAdapter Details Field Definitions Viewing Fabric Information Loop Map Table Definitions Target Information Field Definitions Viewing Target InformationDiscovery 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 InformationFirmware 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 Restoring All Parameters to Their Earlier Values Setting Driver Parameters for a HostResetting All Default 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 Save the file and exit Adding New Targets Using sd.conf for Solaris 8, 9Changing Parameters or Bindings for Solaris 8, 9 Loading or Unloading the Driver Without Rebooting Setting Up Target/LUN Blocking Using sd.confNo-Reboot Firmware Updates Performing Diagnostic Tests Running a Quick Test Click OK. a Post Test window shows Post test information Using BeaconingRunning a Post Test Click Start Dump Creating Diagnostic DumpsDisplaying PCI Registers and Wakeup Information 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 Introduction HBAnyware SecurityRemoving Hosts 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 Getdevlist Command Descriptions emlxadmGetnumdevs Gethostparams Returns the FC login parameters of this HBA port ExampleGetlogiparams wwpn Devlogin wwpn GetsympnameSetsympname string Getsymnname Devlogout wwpn Getstate wwpnDevremove wwpn Linkstatus did Downloadfcode filename GetfwrevDownloadfw filename Downloads the specified FCode image file to the HBA Example Getbootrev Downloadboot filenameGetdumpsize Forcedump Resetlink wwpn or zero for local link ResethardForces the HBA to perform a hardware reset Example Gettopology Diag test parameters or diag code cmdcode hex ResethardcoreForces the HBA to perform a core firmware reset Example Returns the total number of configurable parameters Example Parmgetnum Returns a list of configurable parameters Example ParmgetlistPage Example This example attempts to set a static parameter Parmget labelParmset label value Displays all of the current host HBA API attributes Example Msgbuf all or number -i intervalGethostattrs Getportattrs index, wwn or all = Seagate ST39103FC Getpath index Bootcode enable or disable Displays a help menu of utility commands ExampleGetvpd Exits the utility program Example Repeats the last command Example Hba Emlxdrv utility program can be run in two modes Interactive Interactive Mode emlxdrvModes of Operation emlxdrv CLI Mode emlxdrv Command Descriptions emlxdrv Setemlxs aliasSetemlxssun Setemlxsall Cleardev alias Setlpfc aliasSetlpfcnonsun 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 Cannot modify the Security Configurator HBAnyware Security Configurator Situations Backup MastersHBAnyware Security Configurator Backup Masters Situations Following error message is displayed when Error Message SituationsError Message Situations Master Security Client Situations Master Security Client Situations Master Security Client Situations Introduction Log Message Types Severity Levels Message Log ExampleSeverity Levels Following is an example of a message on the system console Msgid 0004 Error Miscellaneous EventsMsgid 0001 Debug Msgid 0002 Notice Driver Events HBA Initialization Events Msgid 0201 Error Adapter Initialization Failed Msgid 0240 Error Adapter Reset FailedMsgid 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 InvalidMsgid 0452 Debug Iocb Error Msgid 0440 Debug Adapter Msg Mailbox Events Node Events Msgid 0603 Debug Node Updated Msgid 0602 Notice Node Create FailedMsgid 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 ErrorMsgid 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 CompletedMsgid 1312 Warning Echo Diagnostic Failed Msgid 1313 Debug BIU Diagnostic Completed Ioctl Events Firmware Download Events Common Transport Events Msgid 1622 Debug CT reply Msgid 1630 Error Invalid CT command foundMsgid 1621 Debug Unsolicited CT dropped Use Cases Different use cases will drive different migration scenarios Startemlxsmigration.sh Operational Differences Between lpfc and SFSSample Script File Details Finishemlxsmigration.sh Migrating a Configuration without FC Boot Migrating AutomaticallyThings 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