HBAnyware Command Line Version 4.0 User Manual
Contents
1. Syntax hbacmd SetPersistentBinding lt WWPN gt lt Scope gt lt BindType gt lt Targetld gt lt SCSIBus gt lt SCSITarget gt Description Sets a persistent binding between an FC target and a SCSI Bus and target The binding can be to a target WWPN target WWNN or target D_ID Parameters WWPN World Wide Port Name of the adapter whose persistent bindings you want to set Scope P Binding is permanent survives across reboot Binding is immediate B Binding is both permanent and immediate BindType P Enable binding by WWPN N Enable binding by WWNN D Enable binding by D_ID Targetid Target WWPN if BindType P Target WWNN if BindType N Target D_ID if BindType D SCSIBus Bus number of SCSI device SCS Target Target number of SCSI device RemoveAllPersistentBinding Supported by Windows Syntax hbacmd RemoveAllPersistentBinding lt WWPN gt Description Removes all persisting bindings for the adapter Parameters WWPN World Wide Port Name of the adapter whose persistent bindings you want to remove RemovePersistentBinding Supported by Windows Syntax hbacmd RemovePersistentBinding lt WWPN gt lt BindType gt lt ID gt lt SCSIBus gt lt SCSITarget gt HBAnyware Command Line User Manual Page 21 X EMULEX Description Removes persistent binding between an FC target and a SCSI Bus and target The binding to be removed can be to a target WWPN target WWNN or target D_ID Parameters2. Virtual WWPN The WWPN for the virtual port ListVPorts Supported by Windows Linux and VMware ESX Server Syntax hbacmd listvports physical WWPN Description Lists virtual ports on the specified physical port Leaving the physical wwpn parameter blank will list all VPorts on all manageable hosts that support VPorts Parameters Physical WWPN World Wide Port Name of the adapter on which you want to list virtual ports HBAnyware Command Line User Manual Page 23 X EMULEX VPortTargets Supported by Windows Linux and VMware ESX Server Syntax hbacmd vporttargets lt physical WWPN gt lt virtual WWPN gt Description Lists targets visible to the specified virtual port Parameters Physical WWPN World Wide Port Name of the adapter on the targets are visible Virtual WWPN The WWPN for the virtual port WWN Management Commands Note WWN Management validates WWNs very carefully to avoid name duplication Therefore you may see error and warning messages if a name duplication is detected It is strongly recommended that the activation requirement be fulfilled after each WWN change or restore When running with pending changes some diagnostic and maintenance features are not allowed ChangeWWN Supported by Windows Linux and VMware ESX Server Syntax ChangeWWN lt WWPN gt lt New WWPN gt lt New WWNN gt lt Type gt Description Changes the volatile or non volatile state of WWNs If the volatile change
3. WWPN World Wide Port Name of the adapter whose persistent bindings you want to remove BindType P Remove binding by WWPN N Remove binding by WWNN D Remove binding by D_ID ID Target WWPN if BindType P Target WWNN if BindType N Target D_ID if BindType D SCSIBus Bus number of SCSI device SCS Target Target number of SCSI device SetBindingSupport Supported by Windows Syntax hbacmd SetBindingSupport lt WWPN gt lt BindFlag gt Description Enables and sets the binding support s for the adapter Parameters WWPN World Wide Port Name of the adapter whose binding support you want to set and enable BindFlag D Binding by D_ID P Binding by WWPN N Binding by WWNN A Binding by Automap DA Binding by D_ID and Automap PA Binding by WWPN and Automap NA Binding by WWNN and Automap Not available for the Storport Miniport driver TCP IP Management Host File Commands ListHBAs See Miscellaneous Commands on page 18 Addhost Supported by Windows and Linux Syntax hbacmd addhost host_address Description Adds a host to the hosts file The host_address can be an IP address or a host name Parameters host_address Host to add Removehost Supported by Windows and Linux Syntax hbacmd removehost host_address Description Removes a host from the hosts file The host_address can be an IP address or a host name Parameters host_address Host to remove HBAnyware Command
4. During Authentication Authentication Keys Failed Msg Authenticate Failed Client Authenticate Security Not Active Writing File HBAnyware Command Line User Manual X EMULEX Page 26 File Not Found Reading File Encryption Decryption Creating File Header Data Revision Data File Exists Bad Size for Rsp Buf Access Control Data Acquiring Auth Sem Invalid SAID Client Invalid SAID Server Security Not Installed Driver Params IOCTL Get Driver Params IOCTL Set Driver Params Registry Get Driver Params Registry Set Driver Params Conf File Open Driver Params Conf File Write Driver Params Internal Driver Params Not Dynamic Driver Params Range Driver Params Bad Param Name Boot BIOS Not Present Read Wakeup Parms Update Wakeup Parms Disable Boot BIOS Authentication Driver parameter not enabled request rejected Host not found or unreachable Mailbox Busy Retry Mailbox Timed Out Mailbox failed Internal Driver Error Adapter Busy X EMULEX Please go to driver parameter menu and enable this variable HBAnyware Command Line User Manual Page 27 X EMULEX Appendix A Driver Parameters for Windows The parameter values listed in Table 2 are applicable to Storport Miniport driver versions 2 00 or later If you are using a version previous to 2 00 see the Storport Miniport Driver User Manual for that versio
5. Line User Manual Page 22 X EMULEX VPort Commands lt gt Required Optional CreateVPort Supported by Windows and Linux Syntax hbacmd CreateVPort lt physical WWPN gt auto vname or hbacmd CreateVPort lt physical WWPN gt lt virtual WWPN gt lt virtual WWNN gt vname Description Creates a virtual port with an automatically generated WWPN or a specified virtual WWPN on the specified physical port If you specify auto the virtual WWPN will be generated automatically Otherwise you must specify the virtual WWPN for this parameter If creation is successful the WWPN is displayed as part of the output from the command The optional vname parameter can be specified for the virtual port s name Parameters Physical WWPN World Wide Port Name of the object adapter Virtual WWPN The virtual World Wide Port Name Auto The virtual WWPN will be automatically generated for the virtual port Vname The virtual port s name optional or Physical WWPN World Wide Port Name of the object adapter Virtual WWPN The virtual World Wide Port Name to create Vname The virtual port s name optional DeleteVPort Supported by Windows and Linux Syntax hbacmd deletevport lt physical WWPN gt lt virtual WWPN gt Description Deletes the virtual port specified by a physical and virtual WWPN Parameters Physical WWPN World Wide Port Name of the adapter from which you want to delete a virtual port
6. T Make changes temporary Dump Commands DeleteDumpFiles Supported by Windows Linux and VMware ESX Server Syntax hbacmd DeleteDumpFiles lt WWPN gt Description Deletes all diagnostic dump files for the adapter Parameters WWPN World Wide Port Name of the adapter whose diagnostic dump files you want to delete Dump Supported by Windows Linux and VMware ESX Server Syntax hbacmd dump lt WWPN gt Description Displays the maximum number of diagnostic dump files that be can stored for an adapter Creates a diagnostic dump file in the hbacmd dump file directory Parameters WWPN World Wide Port Name of the adapter whose dump information you want to view GetDumpDirectory Supported by Windows Linux and VMware ESX Server Syntax hbacmd GetDumpDirectory lt WWPN gt Description Displays the dump file directory associated with the adapter Parameters WWPN World Wide Port Name of the adapter on which you want to view the dump directory HBAnyware Command Line User Manual Page 16 X EMULEX GetRetentionCount Supported by Windows Linux and VMware ESX Server Syntax hbacmd GetRetentionCount lt WWPN gt Description Displays the maximum number of diagnostic dump files stored for the adapter Parameters WWPN World Wide Port Name of the adapter on which you want to get the retention count SetRetentionCount Supported by Windows Linux and VMware ESX Server Syntax hbacmd SetRetentionCount lt WWPN gt lt
7. Value gt Description Specifies the maximum number of diagnostic dump files stored for the adapter When the number reaches the retention count limit the next dump operation causes the oldest diagnostic dump files for that adapter to be deleted Parameters WWPN World Wide Port Name of the adapter on which you want to set the retention count Value Value you want to assign to the set retention count LUN Masking Commands GetLunList Supported by Windows Syntax hbacmd GetLunList lt HBA WWPN gt lt Target WWPN gt lt Option gt Description Queries for the presence of any LUNs Parameters HBA WWPN World Wide Port Name of the adapter you want to query Target WWPN World Wide Port Name of the target you want to query Option 0 Get information from driver 1 Get information from configuration GetLunUnMaskbyHBA Supported by Windows Syntax hbacmd GetLunUnMaskByHBA lt HBA WWPN gt lt Option gt Description Queries for the presence of any unmasked LUNs by adapter Parameters HBA WWPN World Wide Port Name of the adapter you want to query Option 0 Get information from driver 1 Get information from configuration GetLunUnMaskbyTarget Supported by Windows Syntax hbacmd GetLunUnMaskByTarget lt HBA WWPN gt lt Target WWPN gt lt Option gt Description Queries for the presence of any unmasked LUNs by target HBAnyware Command Line User Manual Page 17 X EMULEX Parameters HBA WWPN World Wide
8. is requested on an adapter that does not support Volatile WWNs an appropriate not supported error is displayed Note When a volatile change is supported a reboot is required to activate the new setting Volatile names will be active until system power down or adapter power cycle Note For VMware ESX Server After changing the WWN of an adapter be sure your zoning settings are updated before you reboot your ESX server If the zoning is not updated before your reboot this could lead to long boot times Parameters WWPN World Wide Port Name of Object adapter New WWPN New World Wide Port Name of Object adapter New WWNN New World Wide Node Name of Object adapter Type 0 Volatile 1 Non Volatile Get Capabilities GetWWNCap on VMware Supported by Windows Linux and VMware ESX Server Syntax hbacmd getwwncap lt WWPN gt Description Shows if volatile change is supported for the WWPN Note A reboot is required to activate the new setting Parameters WWPN World Wide Port Name of Object adapter HBAnyware Command Line User Manual Page 24 X EMULEX ReadWWN Supported by Windows Linux and VMware ESX Server Syntax hbacmd readWWN lt WWPN gt lt Type gt Description Reads different types of WWNs Parameters WWPN World Wide Port Name of Object adapter Type 0 Volatile 1 Non Volatile 2 Factory Default 3 Current 4 Configured RestoreWWN Supported by Windows Linux and VMw
9. tar file for the appropriate Linux version 2 Untar the tar file and run the installation script to install the application If the HBAnyware Security Configurator is installed it must be uninstalled before uninstalling the HBAnyware utility You must run the uninstall script that shipped with the version of HBAnyware Security Configurator that you want to remove Proceed to step 3 If the Security Configurator is not installed proceed to step 4 3 If the HBAnyware Security Configurator is installed follow these steps a Log on as root b Change use cd command to the directory to which you copied the tar file during installation c Run the uninstall script with the ssc parameter specified Type uninstall ssc HBAnyware Command Line User Manual Page 2 X EMULEX 4 Uninstall HBAnyware Iputil and the Application Helper Module a Log on as root b Change use cd command to the directory to which you copied expanded the tar file during installation c Uninstall any previously installed versions Type uninstall d Install the specific RPM for your driver for Linux version Enter the following command all in one line rpm i elxlinuxcorekit version rpm Installing the HBAnyware CLI on a VMware System with an Existing HBAnyware CLI Kit Installed Follow these steps to install the HBAnyware CLI on a VMware system with an existing HBAnyware CLI kit Installed 1 Install the RPM by entering the followin
10. 00 OxEF hex Default 0x00 use soft addressing or flash stored hard address value Note Only valid AL_PAs can be used Determines the number of time out seconds during driver initialization for the link to come up If the link fails to come up by InitTimeout driver initialization exits but is still successful If the link comes up before InitTimeout the driver sets double the amount for discovery to complete Value 5 30 seconds or 0x5 Ox1E hex Default 15 seconds 0xF LinkSpeed has significance only if the adapter supports speeds other than one Gb s Value Auto select 1 Gb s 2 Gb s 4 Gb s 8 Gb s Default Auto select Note Setting this option incorrectly can cause the HBA to fail to initialize Reset Reboot Reset HBAnyware Command Line User Manual Page 30 X EMULEX Table 2 Storport Miniport Driver Parameters Continued Parameter Definitions Activation Requirement LinkTimeOut n LinkTimeOut applies to a private loop only A timer is started on all Dynamic mapped targets using the link timeout value If the timer expires before discovery is re resolved commands issued to timed out devices returns a SELECTIION_TIMEOUT The Storport driver is notified of a Bus change event which leads to the removal of all LUNs on the timed out devices Value 1 500 seconds or 0x0 OxFE hex Default 30 0x1E LogErrors n LogErrors determine the minimum severity level requ
11. Ds to targets based on FC WWNN Ipfc_fcp_bind_WWPN inactive N A N A No Bind specific SCSI IDs to targets based on FC WWPN Ipfc_fcp_class 3 2 3 Yes FC class for FCP data transmission Ipfc_fdmi_on 0 0 2 No False 0 if disabled 1 or 2 if enabled depending on type of support needed Ipfc_iocb_wdog_tmo 40 0 55 No Timeout value for pending FC I O in the driver Ipfc_linkdown_tmo 30 0 255 Yes seconds How long the driver waits before deciding that the FC link is down Ipfc_link_speed 0 O auto select No Sets link speed 1 1 Gb s 2 2 Gb s 4 4 Gb s 8 8 Gb s Ipfc_log_verbose 0x0 0x0 Oxffff Yes bit mask Extra activity logging Ipfc_pci_max_read 0 0 4096 No The maximum number of bytes transferred per pci DMA read The default value 0 means the driver will automatically determine the correct value Ipfc_lun_queue_depth 30 1 128 Yes Default max commands sent to a single logical unit disk Ipfc_lun_skip 0 0 Off 1 On No Allows SCSI layers to detect all LUNs if there are LUN holes ona device lpfc_max_lun 256 1 256 Yes Specifies the maximum number of LUNs per target A value of 20 means LUNs from 0 to 19 are valid lpfc_max_target 256 1 256 No This configuration parameter limits how many targets the driver can support HBAnyware Command Line User Manual Page 37 X EMULEX Table 4 Driver for VMware ESX Configuration Parameters Continued
12. N1 gt lt WWPN2 gt lt PasswordType gt lt Password gt Description Deletes the authentication configuration on the adapter Parameters WWPN1 World Wide Port Name of the adapter whose authentication configuration you want to delete WWPN2 Must be ff ff ff ff ff FFF fF PasswordType 1 ASCII 2 Hex binary 3 Password not yet defined Password Current password value GetAuthConfig Supported by Windows and Linux Syntax hbacmd GetAuthConfig lt WWPN1 gt lt WWPN2 gt Description Retrieves the authentication configuration for the adapter Parameters WWPN1 World Wide Port Name of the adapter whose configuration data you want to retrieve WWPN2 Must be ff ff ff ff ff fF fF fF InitiateAuth Supported by Windows and Linux Syntax hbacmd InitiateAuth lt WWPN1 gt lt WWPN2 gt Description Initiates the authentication configuration on the adapter Parameters WWPN1 World Wide Port Name of the adapter whose authentication configuration you want to initiate WWPN2 Must be ff ff ff ff ff fF fF fF HBAnyware Command Line User Manual Page 8 X EMULEX SetAuthConfig Supported by Windows and Linux Syntax hbacmd SetAuthConfig lt WWPN1 gt lt WWPN2 gt lt PasswordType gt lt Password gt lt Parameter gt lt Value gt Description Sets the authentication configuration for the adapter Parameters WWPN1 World Wide Port Name of the adapter whose authentication configuration you want t
13. PN World Wide Port Name of the adapter whose driver parameters you want to view GetDriverParamsGlobal Supported by Windows Linux and VMware ESX Server For ESX Server version 3 5 0 or earlier the driver used the DriverParamsGlobal command but it has the same format as GetDriverParamsGlobal Syntax hbacmd GetDriverParamsGlobal lt WWPN gt Description Shows the name and the global value of each driver parameter for the adapter Parameters WWPN World Wide Port Name of the adapter whose driver parameter global names and values you want to view SaveConfig Supported by Windows Linux and VMware ESX Server Syntax hbacmd SaveConfig lt WWPN gt lt FileName gt lt Flag gt Description Saves the specified adapter s driver parameters to a file The resulting file contains a list of driver parameter definitions in ASCII file format with definitions delimited by a comma Each definition is of the form lt parameter name gt lt parameter value gt Saves either the values of the global set or those specific to the HBA The file created by this command is stored in the Emulex Repository directory Parameters WWPN World Wide Port Name of the adapter whose configuration data you want to save FileName Name of the file that contains the driver parameters list Flag G Save the global parameter set N Save the local HBA specific parameter set SetDriverParam Note When the SetDriverParam driver parameter is set per
14. Port Name of the adapter you want to query Target WWPN World Wide Port Name of the target you want to query Option 0 Get information from driver 1 Get information from configuration RescanLuns Supported by Windows Syntax hbacmd RescanLuns lt HBA WWPN gt lt Target WWPN gt Description Rescans for the presence of any LUNs Parameters HBA WWPN World Wide Port Name of the adapter you want to rescan Target WWPN World Wide Port Name of the target you want to rescan SetLunMask Supported by Windows Syntax hbacmd SetLunMask lt HBA WWPN gt lt Target WWPN gt lt Option gt lt Lun gt lt LunCount gt lt MaskOp gt Description Masks the specified LUNs Parameters HBA WWPN World Wide Port Name of the adapters Target WWPN World Wide Port Name of the target Option 0 Send information to the driver 1 Send information to configuration make persistent 2 Send information to both Lun Starting LUN number LunCount Number of LUNs MaskOp A Mask LUN B Clear unmask target level C Clear unmask HBA level D Unmask LUN E Unmask target level F Unmask HBA level Miscellaneous Commands lt gt Required Optional Download Supported by Windows Linux and VMware ESX Server Syntax hbacmd Download lt WWPN gt lt FileName gt Description Loads the firmware image to the adapter Parameters WWPN World Wide Port Name of the adapter to which you want to load firm
15. SCSI IDs to FCP targets detected Ipfc_check_cond_err 0 Off 1 On Yes Treat certain FCP check conditions as FCP RSP errors Ipfc_cr_count 255 No This parameter determines the values for I O coalescing for cr_delay msec or cr_count outstanding commands Ipfc_cr_delay 63 No This parameter determines the values for I O coalescing for cr_delay msec or cr_count outstanding commands Ipfc_delay_rsp_err 0 Off 1 On Yes Treat FCP RSP errors like no device delay Ipfc_discovery_threads 64 No Specifies the maximum number of ELS commands that can be outstanding for a discovery Ipfc_dafull_throttle_up_inc 128 Yes Amount to increment LUN queue depth each time Ipfc_dafull_throttle_up_time lpfc_extra_io_tmo HBAnyware Command Line User Manual 30 255 Yes Yes Time interval in seconds to increment LUN queue depth Extra FCP cmd timeout when connected to a fabric in seconds Page 36 X EMULEX Table 4 Driver for VMware ESX Configuration Parameters Continued Variable Default Min Max Dynamic Comments Ipfc_fcp_bind_DID inactive N A N A No Bind specific SCSI IDs to targets based on FC Port ID lpfc_fcp_bind_method 2 1 4 No Specifies the bind method WWWN WWPN DID ALPA map to be used lpfc_fcp_bind_ WWNN inactive N A N A No Bind specific SCSI I
16. ULEX Boot Commands lt gt Required Optional EnableBootCode Supported by Windows Linux and VMware ESX Server Syntax hbacmd EnableBootCode lt WWPN gt lt Flag gt Description Enables or disables the boot code on the adapter If the boot code is disabled the adapter will not boot from SAN regardless of the value for the EnableBootFromSan boot param If it is enabled the adapter will boot from the SAN if the EnableBootFromSan parameter is also enabled Parameters WWPN World Wide Port Name of Object adapters Flag E Enable the boot code D Disable the boot code GetBootParams Supported by Windows Linux and VMware ESX Server Syntax hbacmd GetBootParams lt WWPN gt lt Type gt Description Shows the boot parameters If any arguments are missing or invalid a suitable error is reported If all arguments are ok the appropriate RM_GetBootParamsXxX call is made and the data is displayed in tabular form Parameters WWPN World Wide Port Name of Object adapter Type X86 EFI OB SetBootParam Supported by Windows Linux and VMware ESX Server Syntax hbaCmd SetBootParam lt WWPN gt lt Type gt lt Param gt lt Value1 gt BootDev lt Value2 gt Description Performs a high level read modify write operation e For Adapter Params the BootDev keyword and value must be omitted otherwise an error is reported e For Boot Device Params OpenBoot the BootDev keyword and value must be omitted ot
17. Variable Default Min Max Dynamic Comments Ipfc_max_vpi Oxffff 0 Oxffff No NPIV Maximum number of vpis available per physical port Ipfc_nodev_holdio 0 0 Off 1 On Yes If the device disappears hold I O until it comes back Ipfc_no_device_delay 1 0 30 Yes Delay to fail back an I O in seconds Ipfc_nodev_tmo 30 0 255 Yes Seconds to hold I O err if device disappears Ipfc_ns_threads 2 1 32 Yes NPIV Number of concurrent NameServer requests allowed to be outstanding Ipfc_peer_vport_login 0 0 1 Yes NPIV Allows peer Vports to log into each other Ipfc_scan_down 1 0 Off 1 On Yes Select method for scanning ALPA to assign a SCSI ID Ipfc_scsi_req_tmo 30 0 255 Yes Time out value in seconds for SCSI passthrough requests Ipfc_tgt_queue_depth 0 0 8192 Yes Default max commands sent to a single target Ipfc_topology 0 0x0 loop No FC link topology defaults to loop if then P2P it fails attempts point to point 0x2 P2P only mode 0x4 loop only 0x6 P2P then loop Ipfc_use_adisc 0 0 Off 1 On Yes Send ADISC instead of PLOGI for device discovery or RSCN Ipfc_xmt_que_size 256 128 8192 No Number of outstandng commands for an adapter HBAnyware Command Line User Manual Page 38
18. X EMULEX HBAnyware Command Line Version 4 0 User Manual P004743 01A Rev A Critical Connectivity Solutions X EMULEX Copyright 2008 Emulex All rights reserved worldwide No part of this document may be reproduced by any means nor translated to any electronic medium without the written consent of Emulex Information furnished by Emulex is believed to be accurate and reliable However no responsibility is assumed by Emulex for its use or for any infringements of patents or other rights of third parties which may result from its use No license is granted by implication or otherwise under any patent or patent rights of Emulex Emulex AutoPilot Installer BlockGuard cLAN FabricStream FibreSpy Giganet HBAnyware InSpeed IntraLink LightPulse MultiPulse SAN Insite SBOD and Vixel are registered trademarks and AutoPilot Manager Critical Connectivity Solutions EZPilot SLI and VMPilot are trademarks of Emulex All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations Emulex provides this manual as is without any warranty of any kind either expressed or implied including but not limited to the implied warranties of merchantability or fitness for a particular purpose Emulex may make improvements and changes to the product described in this manual at any time and without any notice Emulex assumes no responsibility for its use nor for any infring
19. an be 0 to 3 Reset If set to 0 0x0 FC Arbitrated Loop FC AL If set to 1 0x1 PT PT fabric If set to 2 0x2 FC AL first then attempt PT PT If set to 3 0x3 PT PT fabric first then attempt FC AL Topology fail over requires v3 20 firmware or higher If firmware does not support topology fail over options 0 2 and 1 3 are analogous Value 0 3 Default 2 0x2 HBAnyware Command Line User Manual Page 32 X EMULEX Table 2 Storport Miniport Driver Parameters Continued Parameter Definitions Activation Requirement TraceBufSiz n TraceBufSiz sets the size in bytes for the internal driver trace buffer The internal driver trace buffer acts as an internal log of the driver s activity Value 250 000 2 000 000 or 0x3D090 0x1E8480 hex Default 250 000 0x3D090 Reboot HBAnyware Command Line User Manual Page 33 Appendix B Driver Parameters for Linux X EMULEX The information contained in the following table is useful when entering commands related to driver parameters Table 3 Open Source Linux Driver Parameters Variable Default Min Max Comments ackO 0 0 Off 1 On Valid for all drivers Uses ACKO for class 2 cr_count 1 255 Determines the values for I O coalescing for cr_delay msec or cr_count outstanding commands cr_delay Determines the values for I O coalescing for cr_delay msec or cr_count outstanding
20. apter Type None Help SetBootParams Supported by Windows Linux and VMware ESX Server Syntax hbacmd Help SetBootParams Description Shows help for the SetBootParams command Parameters None Attributes Commands HBAAttributes Supported by Windows Linux and VMware ESX Server Syntax hbacmd HBAAttributes lt WWPN gt Description Shows a list of all HBA attributes Parameters WWPN World Wide Port Name of the HBA whose attributes you want to view PortAttributes Supported by Windows Linux and VMware ESX Server Syntax hbacmd PortAttributes lt WWPN gt Description Shows a list of all port attributes for the adapter Parameters WWPN World Wide Port Name of the adapter whose port attributes you want to view PortStatistics Supported by Windows Linux and VMware ESX Server Syntax hbacmd PortStatistics lt WWPN gt Description Shows all port statistics for the adapter Parameters WWPN World Wide Port Name of the adapter whose port statistics you want to view HBAnyware Command Line User Manual Page 7 X EMULEX ServerAttributes Supported by Windows Linux and VMware ESX Server Syntax hbacmd ServerAttributes lt WWPN gt Description Shows a list of server attributes for the adapter Parameters WWPN World Wide Port Name of the adapter whose server attributes you want to view Authentication Commands DeleteAuthConfig Supported by Windows and Linux Syntax hbacmd DeleteAuthConfig lt WWWP
21. are ESX Server Syntax RestoreWWN lt WWPN gt lt Type gt Description Quickly changes the WWNs back to the factory default or non volatile values This change is non volatile Note A reboot is required to activate the new setting Parameters WWPN World Wide Port Name of Object adapter Type 0 Restore Default WWNs 1 Restore NVRAM WWNs HBAnyware Command Line User Manual Page 25 ASCII Strings that May Be Returned Invalid Handle Invalid Argument Illegal WWN Illegal Index More Data Bad Local Bus Number Bad Local Target Number Bad Local LUN Local SCSI ID Already Bound No Such Binding Target Not Found Internal Call Failed Insufficient Buff Install Dir Not Found Path Length Partial data returned Buffer Overflow Response Timeout Link Unavailable Insufficient Resources Existing Registration Invalid Tag Invalid WWN Create Event Failed Node Bind Reboot Node Bind Immediate Failed Set PBind Failed Bound to Diff SCSI ID Resource Allocation Wrong Bind Type SCSI ID Already Bound RSC Type Authenticate Failed Opening Resource Reading Resource Invalid FW Image Base Short FW Image Long FW Image Bad Checksum Incompatible Image Buffer Allocation No Local HBA Insufficient Buffer Size Not an Emulex Port Download In Progress Bad Data SCSI Check Condition Null Buffer Get Driver Type Unauthorized SAID
22. caaaeceeeeeeeeeceaaaeeeeeeeeeeeeaaaaeees 16 LUN Masking Commands ssncsnnnninnnnnnnaninaannnan 17 Miscellaneous Commands ccccccceeeeneeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeetatenttess 18 Persistent Binding COMMAMNAS cccccceeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeteeeeeteess 20 TCP IP Management Host File COMMAMNAS cciceeeeeeeeeeeeeeeeeeeeeees 22 VPort COMMANAS ccccccccceeeeeeeeeeeeeeeeeeeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeetenes 23 WWN Management Commands ccccccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeteenenees 24 ASCII Strings that May Be Returned 0 0 00 eeeeeeeerereeees 26 Appendix A Driver Parameters for Windows ccccceeeeeeeeeeeeeneeeeeeeeeneeeeeeeeeeeanes 28 Appendix B Driver Parameters for Linux ceceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaees 34 Appendix C Driver Parameters for VMware 22 ccccceeeeceeeeeeeeeeeeeeeeneeeeeeneeeeeeeees 36 HBAnyware Command Line User Manual Page iii X EMULEX Installing the HBAnyware CLI Introduction The HBAnyware Command Line Interface CLI is a comprehensive management utility for Emulex host bus adapters HBAs that provides support for commonly used commands without requiring installation of the HBAnyware Graphical User Interface GUI The HBAnyware CLI is a separate application with core driver kits that do not include the HBAnyware GUI The HBAnyware CLI console application name is hbacmd and can be insta
23. commands enable_auth This driver property specifies if DHCHAP is enabled or not When set to 1 DHCHAP is enabled When set to 0 DHCHAP support is disabled NOTE This property requires a link reset to activate enable_npiv This parameter controls the driver s ability to use NPIV to create virtual ports It defaults to off 0 which prevents the driver from creating any virtual ports When enabled set to 1 it enables you to create and delete virtual ports if supported by the fabric fcp_class The Fibre Channel class for FCP data transmission fdmi_on 0 False if disabled 1 True if enabled 2 True if enabled Enables or disables Fabric Device Management Interface FDMI functionality False 0 if disabled 1 or 2 if enabled depending on type of support needed link_speed O auto select 1 1 Gb s 2 2 Gb s 4 4 Gb s Sets link speed HBAnyware Command Line User Manual Page 34 Table 3 Open Source Linux Driver Parameters X EMULEX Variable Default Min Max Comments log_verbose 0x0 0x0 Oxffff This bit mask controls extra activity logging No driver reload is required lun_queue_depth 30 1 128 The default maximum commands sent to a single logical unit disk max_luns 256 1 32768 Specifies the maximum number of LUNs per target A value of 20 means that 19 LUNs 0 19 are valid nodev_tmo 30 1 255 Seconds
24. ements of patents or other rights of third parties that may result Periodic changes are made to information contained herein although these changes will be incorporated into new editions of this manual Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 OpenSolaris DHCHAP Notice Contains portions of Covered Software subject to the Common Development and Distribution License CDDL Version 1 0 Such portions of Covered Software in Source Code form may be obtained from the web site www opensolaris org or by contacting online support from the web site www emulex com Derived from the RSA Data Security Inc MD5 Message Digest Algorithm Copyright C 1991 2 RSA Data Security Inc Created 1991 All rights reserved HBAnyware Command Line User Manual Page ii ma Table of Contents gt gt EMULEX Installing the HBAnyware CLI ossitisiisisiiiiisidisidinidinidiiidinii iiid iiii diidinan a 1 rodu TOMS a E E E 1 WINGOWS oaaao tanasanitana narikan baikan satika rani kananan ana aaa kana nana kada dada aaa daai aaa aa TARA 1 EINU ea e E E E amapannamuteasannees 1 M MWC assassin aaa aaa a aaa aa aaa aa aaa a aaa 1 Prerequisites cccceccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaaaeaaeeeeeeeeeseaaaageeeeeeeeesaaaeaees 1 PrOCEdUTOS ici cicieliledetietiedeleliheschedadepettceletelapelateielifaiitetiiesiietileiihelaieiiieitens 2 Installing the HBAnyware CLI on a Linux System with an Ex
25. g command esxcfg firewall q The TCP port number can be changed If it is not changed the default is 23333 Refer to the VMware Server Configuration Guide for more details on how to configure the ESX firewall Using the CLI Client Syntax Rules The syntax rules for hbacmd are as follows e All CLI Client commands and their arguments are not case sensitive e The requested operation must contain at least three characters or as many as needed to distinguish it from any other operation e Whenever a WWPN is specified individual fields are separated by colons or spaces When using space separators the entire WWPN must be enclosed in quotes HBAnyware Command Line User Manual Page 5 X EMULEX The CLI Client Command Reference CLI Client commands are supported for Windows Linux and VMware ESX Server Only CLI Client commands that are dynamic are supported for VMware ESX Server Note The PersistentBinding SetPersistentBinding RemovePersistentBinding RemoveAllPersistentBinding BindingCapabilities BindingSupport and SetBindingSupport commands are not supported for Linux Note The BindingCapabilities BindingSupport GetLunList PersistentBinding RescanLuns RemoveAllPersistentBinding RemovePersistentBinding SetBindingSupport SetLunMask and SetPersistentBindingcommands exist in the Emulex driver for ESX Server 3 5 0 but are not supported Note The GetLunMaskbyHBA and GetLunMaskbyTarget c
26. g command all on one line rpm U elxvmwarecorekit version rpm Uninstalling Older HBAnyware Kits on VMware 1 Log in as root 2 Type rpm qa grep elx and locate the following rpm file elxvmwarecorekit lt kit version gt The rpm contents are installed in usr sbin nbanyware The hbacmd utility is also located in this directory 3 Type rpm e elxvmwarecorekit lt kit version gt Upgrading from CLI to Full Featured HBAnyware Windows To upgrade from the HBAnyware CLI to the full featured HBAnyware utility 1 From the desktop run the storportminiportkit_ version exe file that contain the full application kit version represents the complete version For example storportminiportkit_1 30a9 1d Running this executable file removes the HBAnyware CLI and installs a full featured version of the HBAnyware utility that includes the CLI and the GUI Linux To upgrade from the HBAnyware CLI to the full featured HBAnyware utility 1 Uninstall the core kit using rpm e elxlinuxcorekit version 2 Install the HBAnyware kit using the install script within the tar file HBAnyware Command Line User Manual Page 3 X EMULEX VMware The full featured HBAnyware kit is not supported on VMware ESX Server HBAnyware Command Line User Manual Page 4 X EMULEX Using the HBAnyware Utility Command Line Interface The Command Line Interface CLI Client component of the HBAnyware utility provides access to the capab
27. herwise an error is reported e For Boot Device Params X86 and EFI the BootDev keyword and value are required Parameters WWPN World Wide Port Name of Object adapter Type X86 EFI OB Param Parameter Name Value1 Parameter Value Value2 Boot Device Entry Number 0 7 HBAnyware Command Line User Manual Page 10 X EMULEX CEE Commands Note CEE commands are for CEE management of LP21000 and LP21002 HBAs only CEEDownload Supported by Windows Linux and VMware ESX Server Syntax hbacmd CEEDownload lt WWPN gt lt Filename gt Description Updates the CEE firmware on the adapter Parameters WWPN World Wide Port Name of the adapter Filename Name of the file to download GetCEEParams Supported by Windows Linux and VMware ESX Server Syntax hbacmd GetCEEParams lt WWPN gt Description Shows the current CEE parameters Parameters WWPN World Wide Port Name of the adapter SetCEEParam Supported by Windows Linux and VMware ESX Server Syntax hbacmd SetCEEParam lt WWPN gt lt Param gt lt Value gt Description SetCEEParam configures one of the CEE parameters Parameters Pausetype 1 Standard 2 Per Pause Priority Pfcpriority 8 bits each bit representing a pause priority 0 7 e g 170 priorities 7 5 3 1 Fcoepriority 0 7 Uifporttype 1 Access 2 Trunk HBAnyware Command Line User Manual Page 11 X EMULEX Diagnostic Commands EchoTest Supported by W
28. ic authentication This feature requires the authentication to be supported by the fabric Authentication is enabled when this value is set to 1 Value 0 1 Default 0 Reboot EnableFDMI n If set to 1 enables management server login on fabric discovery This allows Fabric Device Management Interface FDMI to operate on switches that have FDMI capable firmware If set to 2 FDMI operates and uses the host name feature of FDMI Value 0 2 decimal Default 0 Reset HBAnyware Command Line User Manual Page 29 X EMULEX Table 2 Storport Miniport Driver Parameters Continued Parameter Definitions Activation Requirement EnableNPIV n If set to 1 enables N_Port_ID virtualization NPIV Requires NPIV supported firmware for the adapter Value 0 1 Default 0 disabled Note To run the driver using NPIV or SLI 3 optimization the firmware must be version 2 72a0 or later If an earlier version is used the driver runs in SLI 2 mode and does not support NPIV Note NPIV is not available on 1Gb s and 2 Gb s HBAs Reset FrameSizeMSB n FrameSizeMSB controls the upper byte of receive FrameSize if issued in PLOGI This allows the FrameSize to be constrained on 256 byte increments from 256 1 to 2048 8 Value 0 8 Default 0 Reset HardALPA 0xn InitTimeout n LinkSpeed n HardALPA allows the adapter to use a hard assigned loop address Value 0x
29. ilities of the Remote Management library from a console command prompt This component is intended for use in scripted operations from within shell scripts or batch files The CLI Client is a console application named hbacmd Each time you run this application from the command line a single operation is performed The first parameter of this command is the requested operation When the specified operation is completed the command prompt is displayed Most operations retrieve information about an entity on the SAN and display that information on the console Most of the CLI Client commands require one or more additional parameters that specify the nature of the command The World Wide Port Name WWPN is an example of a widely used parameter required by many hbacmd commands For example run the following command from the directory in which HBAnyware is installed to display the port attributes for the HBA with the specified WWPN hbacmd portattrib 10 00 00 00 c9 20 20 20 hbacmd can be run in TCP IP mode by making the first argument h lt host gt For example hbacmd h cp hp5670 listhbas hbacmd h 138 239 91 121 listhbas Note For the VMware ESX Server the firewall on the ESX Server must be opened to manage systems remotely To enable TCP port 23333 run the following commands esxcfg firewall openPort 23333 tcp in hbanyware esxcfg firewall openPort 23333 tcp out hbanyware To verify that the correct port is open run the followin
30. indows Linux and VMware ESX Server Syntax hbacmd EchoTest lt WWPN Source gt lt WWPN Destination gt lt Count gt lt StopOnError gt lt Pattern gt Description Runs the echo test on adapters Note Support for remote HBA is TCP IP access only The EchoTest command fails if the target WWPN does not support the ECHO ELS command Parameters Source WWPN World Wide Port Name of the originating adapter Destination WWPN World Wide Port Name of the destination echoing adapter Count Number of times to run the test 0 run test infinitely StopOnError Should the test be halted on Error 0 No halt 1 Halt Pattern Hexadecimal data pattern to transmit up to 8 characters GetBeacon Supported by Windows Linux and VMware ESX Server Syntax hbacmd GetBeacon lt WWPN gt Description Shows the current beacon status for the adapter Parameters WWPN World Wide Port Name of the adapter whose current beacon you want to view LoadList Supported by Windows Linux and VMware ESX Server Syntax hbacmd LoadList lt WWPN gt Description Shows the flash load list data for the adapter Parameters WWPN World Wide Port Name of the adapter whose flash load list data you want to view Loopback Supported by Windows Linux and VMware ESX Server Syntax hbacmd loopback lt WWPN gt lt Type gt lt Count gt lt StopOnError gt lt Pattern gt Description Runs the loop test on the adapter specified by the WWPN N
31. ired to enable Dynamic entry of a logged error into the system event log Errors are classified as severe malfunction or command level A severe error requires user intervention to correct a firmware or adapter problem An invalid link speed selection is an example of a severe error A malfunction error indicates that the system has problems but user intervention is not required An invalid fabric command type is an example of a malfunction error A command level error an object allocation failure is an example of a command error If set to 0 all errors are logged If set to 1 command level errors are logged If set to 2 malfunction errors are logged If set to 3 severe errors are logged Value 0 3 Default 3 NodeTimeout n The node timer starts when a node i e discovered target or initiator Dynamic becomes unavailable If the node fails to become available before the NodeTimeout interval expires the OS is notified so that any associated devices if the node is a target can be removed If the node becomes available before NodeTimeout expires the timer is canceled and no notification is made Value 1 255 seconds or 0x0 OxFF hex Default 30 0x1E QueueDepth n QueueDepth requests per LUN target see QueueTarget parameter Dynamic If you expect the number of outstanding I Os per device to exceed 32 then you must increase to a value greater than the number of expected I Os per device up to a value of 254 If the QueueDepth val
32. isting HBAnyware CLI Kit Installed ee 2 Installing the HBAnyware CLI on a VMware System with an Existing HBAnyware CLI Kit Installed 0 cccceeeeeeeeeeeeeeeeeeeeeeeeeneeeeeees 3 Upgrading from CLI to Full Featured HBAnywate eerie 3 WV AG OW Soe cece ccna EE E E E cae en eaenesaaee catonpaueeesaaesets 3 PMU EAE date tabatenatintatanetadabedute A talatahatatedataanas 3 VMWare eaa A E A A E 4 Using the HBAnyware Utility Command Line Interface i ceeeeeeeeeteeeeeees 5 Using the CLI Client 0 0 cieeeeeeeeeeeeeceeeeeeeeeeeeeeeeeeeeeeeeeeaaaaaaaaaaaaaaaaaeeeeeenees 5 Oyhtax RUS sisi sicicccicseiaieladaiaielaiaiaieieieieieieieieieialeieaeieieieitlaleiaieiaieieitialeiaaetee 5 The CLI Client Command Reference eee 6 Read Only Mode ccccccccccecceecateitecttetincnatetaceceeccceeeeneeeeedenttenetetanenebenahnaaceuedenees 6 Help Commands oieee aaa aaa aaa a aeaa da a aaa aa da a aAa AEREE 6 Attributes COMMAMNAS cccccccceeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeteneas 7 Authentication CommandS ceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaaaaaaaaaaaaeeeeenees 8 Boot COmmMINI Secci iiaeie ieie ei ei ei eiae eE 10 CEE COMMANGS srcnreiriiraesa a EE 11 Diagnostic COMMAMNAS 2 0 ee tee eer tr ree aaa aaa aaa aaa aaaaaaaaaaaeeeeeees 12 Driver Parameter COMMANAS cece eeeeeeeeeetettttteeeettt eae aaa aaaaaaaaaeeeeeees 14 Dump Commands cceeeeeeece cece ee eeeeeeeeeeee
33. lled on Windows Linux and VMware A single operation is performed by entering hbacmd at the command line For syntax information and details on using the HBAnyware CLI see Using the HBAnyware Utility Command Line Interface on page 5 Platforms that are supported with the HBAnyware CLI are detailed in Table 1 Table 1 HBAnyware Command Line Interface Supported Platforms Driver Architecture Operating System Storport Miniport Driver Intel x86 IA 64 EM64T and AMD64 Windows Server 2008 Windows Server 2003 LPFC 7 4 x Driver Intel x86 EM64T and AMD64 VMware ESX Server 3 5 Open Source Driver for Intel x86 EM64T AMD64 PPC64 RHEL 4 Updates 3 4 and 5 and later RHEL4 and SUSE Linux and IA 64 SUSE Linux Enterprise Server 9 SP Enterprise Server SLES 9 2 or later Open Source Driver for RHEL Intel x86 EM64T AMD64 PPC64 RHEL 5 RHEL 5 1 and RHEL 5 2 5 and SLES 10 and IA 64 SUSE Linux Enterprise Server Windows To install the HBAnyware CLI run an installation exe file for a core Windows driver kit that does not include the HBAnyware GUI e storportminiportcorekit_ version exe version represents the complete version For example storportminiportcorekit_1 30a9 1d Linux Before installing the core kit the 8 0 or 8 2 driver must be installed For 8 0 systems RHEL4 SLES9Q the Ipfcdfc IOCTL module must also be installed To install the HBAnyware CLI on a new system install the specific dri
34. n s parameter information Activation Requirements A parameter has one of the following activation requirements e Dynamic The change takes effect while the system is running e Reset Requires an adapter reset from the utility before the change takes effect e Reboot Requires reboot of the entire machine before the change takes effect In this case you are prompted to perform a reboot when you exit the utility The Driver Parameter table provides information such as the allowable range of values and factory defaults Parameters can be entered in decimal or hexadecimal format Note If you are creating custom unattended installation scripts any driver parameter can be modified and included in the script Most parameters default to a setting that optimizes adapter performance Table 2 Storport Miniport Driver Parameters Parameter Definitions Activation Requirement AutoMap n AutoMap controls the way targets are assigned SCSI IDs Discovered Reboot targets are assigned persistent SCSI IDs according to the selected binding method Persistent bindings do not take effect with the driver in stand alone mode If set to 0 automap is disabled Uses the HBAnyware utility to persistently set the SCSI address of a discovered FCP capable FC node target If set to 1 automap by WWNN If set to 2 automap by WWPN If set to 3 automap by DID Value 0 3 Default 2 Class n Class selects the class of
35. o set WWPN2 Must be ff ff ff ff ff ff ff ff PasswordType 1 ASCII 2 Hex binary 3 Password not yet defined Password Current password value Parameter Parameters include Mode Timeout Bi directional Hash priority DH priority Re authentication Re authentication interval Value Parameter specific value Mode lt disabled enabled passive gt Timeout time in seconds Bi directional lt disabled enabled gt Hash priority lt md5 sha1 gt md5 first md5 then sha1 sha1 first sha1 then md5 DH priority lt 1 2 3 4 5 gt any combination up to 5 digits Re authentication lt disabled enabled gt Re authentication interval lt 0 10 3600 gt SetPassword Supported by Windows and Linux Syntax hbacmd SetPassword lt WWPN1 gt lt WWPN2 gt lt Flag gt lt Cpt gt lt Cpw gt lt Npt gt lt Npw gt Description Sets the password for the adapter Parameters WWPN1 World Wide Port Name of the adapter for which you want to set a password WWPN2 Must be ff ff ff ff ff ff ff ff Flag 1 Local password used by adapter when adapter authenticates to the switch 2 Remote password used by adapter when switch authenticates to the adapter Cpt Current password type is 1 ASCII or 2 Hex binary 3 Password not yet defined Cpw Current password value Npt New password type is 1 ASCII or 2 Hex binary Npw New password value HBAnyware Command Line User Manual Page 9 X EM
36. om 1 SLI 3 0x00000000 0x00000000 SLI 4 0x00000000 0x00000000 Expansion Rom 0x03B11713 0x00101303 The changes suggested for HBAnyware s GUI also apply to this command s output PostTest Supported by Windows Linux and VMware ESX Server Syntax hbacmd PostTest lt WWPN gt Description Runs the POST on the HBA Support for a remote adapter is TCP IP access only Parameters WWPN World Wide Port Name of the HBA on which you want to run a POST HBAnyware Command Line User Manual Page 13 X EMULEX SetBeacon Supported by Windows Linux and VMware ESX Server Syntax hbacmd SetBeacon lt WWPN gt lt BeaconState gt Description Sets the current beacon status for the adapter Parameters WWPN World Wide Port Name of the adapter whose beacon you want to change BeaconState New state of the beacon 0 Off 1 On Wakeup Supported by Windows Linux and VMware ESX Server Syntax hbacmd Wakeup lt WWPN gt Description Shows wakeup parameter data for the adapter Parameters WWPN World Wide Port Name of the adapter whose wakeup parameter data you want to view Driver Parameter Commands Note Whenever you chose to set a temporary driver parameter that is not permanently the parameter is set on each adapter This method is slightly different then the way it is done for a permanently changed driver parameter Because of this the temporarily changed driver parameter must be viewed as an adapter specific change To see thi
37. ommands do not exist for ESX Server 3 5 0 Read Only Mode The CLI hbacmd does not allow execution of sensitive commands when HBAnyware is configured for read only mode An error message will be displayed if such a command is attempted Error Read only management mode is currently set on this host The requested command is not permitted in this mode Help Commands Help Supported by Windows Linux and VMware ESX Server Syntax HbaCmd Help Description Shows a list of all help commands for the HBAnyware CLI Client application Parameters None Help Boot Supported by Windows Linux and VMware ESX Server Syntax HbaCmd Help Boot Description Shows a list of all help commands for the boot commands Parameters None Help BootParams Supported by Windows Linux and VMware ESX Server Syntax hbacmd Help BootParams lt Parameter Name gt Description Shows a summary of parameter settings for the adapter and the boot device Several parameters have detailed help available Parameters Parameter Name optional Specify one of the following boot parameters AutoScan BootTargetScan DevicePathSelection LinkSpeed PlogiRetryTimer or BootParams Topology HBAnyware Command Line User Manual Page 6 X EMULEX Help GetBootParams Supported by Windows Linux and VMware ESX Server Syntax hbacmd Help GetBootParams Description Shows help for the GetBootParams command Parameters WWPN World Wide Port Name of Object ad
38. ote Only external loopback tests must be run with TCP IP access Note Internal and External Loopback tests are not available for LP21000 and LP21002 adapters Parameters WWPN World Wide Port Name of the adapter on which you want to run loopback HBAnyware Command Line User Manual Page 12 X EMULEX Type 0 PCI LoopBack Test 1 Internal LoopBack Test 2 External LoopBack Test Count Number of times to run the test 0 run test infinitely Range 1 99 999 StopOnError Should the test be halted on Error 0 No halt 1 Halt Pattern Hexadecimal data pattern to transmit up to 8 characters LoopMap Supported by Windows and Linux Syntax hbacmd LoopMap lt WWPN gt Description Shows the arbitrated loop map data for the adapter Parameters WWPN World Wide Port Name of the adapter whose arbitrated loop map data you want to view PCIData Supported by Windows Linux and VMware ESX Server Syntax hbacmd PCIData lt WWPN gt Description Shows PCI configuration data for the adapter Parameters WWPN World Wide Port Name of the adapter whose configuration data you want to view HBACMD has a command that displays wakeup parameter information much the same way that HBAnyware displays it in its own control field Wakeup Parameters Initial Load 0x02B81991 0x00555637 Flags 0x00000000 Boot BIOS 0x03B11713 0x00101303 SLI 1 0x06B21991 0x00103411 SLI 2 0x07B21991 0x00103411 Has Expansion R
39. s change use GetDriverParameter rather than GetDriverParameterGlobal Also when you run SaveConfig you must run it with the N option adapter specific This will gather all the values saved on that HBA This command must be used cautiously DriverConfig Note When the DriverConfig driver parameter is set persistently and or requires a reboot the ramdisk must be rebuilt To build the ramdisk type esxcfg boot b reboot Supported by Windows and VMware ESX Server Syntax hbacmd DriverConfig lt WWPN gt lt FileName gt lt Flag gt Description Sets all driver parameters for the adapter to the driver parameter values contained in the specified dpv file type The dpv file s driver type must match the driver type of the host platform adapter Parameters WWPN World Wide Port Name of the adapter whose driver parameters you want to set FileName Name of the dpv file the file is stored in the Emulex Repository directory Flag G Make change global all HBAs on this host N Make change non global HBA specific GetDriverParams Supported by Windows Linux and VMware ESX Server For VMware ESX Server version 3 5 0 or earlier the driver used the DriverParams command but it has the same format as GetDriverParams Syntax hbacmd GetDriverParams lt WWPN gt HBAnyware Command Line User Manual Page 14 X EMULEX Description Shows the name and values of each driver parameter for the adapter Parameters WW
40. service on FCP commands Dynamic If set to 2 class 2 If set to 3 class 3 Value 2 3 Default 3 HBAnyware Command Line User Manual Page 28 X EMULEX Table 2 Storport Miniport Driver Parameters Continued Parameter Definitions Activation Requirement CoalesceMsCnt n CoalesceMsCn specifies wait time in milliseconds to generate an interrupt response if CoalesceRspCnt has not been satisfied Zero specifies an immediate interrupt response notification A non zero value enables response coalescing at the specified interval in milliseconds Value 0 63 decimal or 0x0 Ox3F hex Default 0 0x0 Reset CoalesceRspCnt n DiscoveryDelay n CoalesceRspCn specifies the number of response entries that trigger an Interrupt response Value 0 255 decimal or 0x1 OxFF hex Default 8 0x8 DiscoveryDelay controls whether the driver waits for n seconds to start port discovery after link up If set to 0 immediate discovery after link up If set to 1 or 2 the number of seconds to wait after link up before starting port discovery Value 0 2 seconds decimal Default 0 Reset Dynamic EnableAck0 n Set to 1 to force sequence rather than frame level acknowledgement for class 2 traffic over an exchange This applies to FCP data exchanges on IREAD and IWRITE commands Value 0 1 decimal Default 0 Reset EnableAUTH EnableAUTH enables fabr
41. sistently and or requires a reboot the ramdisk must be rebuilt To build the ramdisk type esxcfg boot b reboot Supported by Windows Linux and VMware ESX Server Description Allows you to change the value of a driver parameter and designate the scope of that change Parameters WWPN World Wide Port Name of the adapter whose driver parameters you want to change Flag1 L Make change local for this adapter only G Make change global all adapters on this host Flag2 P Make change permanent persists across reboot T Make change temporary Param Name of the parameter to modify Value New value you want to assign to the parameter Input as decimal prefix with Ox to input as hex HBAnyware Command Line User Manual Page 15 X EMULEX SetDriverParamDefaults Note When the SetDriverParamDefaults driver parameter is set persistently and or requires a reboot the ramdisk must be rebuilt To build the ramdisk type esxcfg boot b reboot Supported by Windows Linux and VMware ESX Server Syntax hbacmd SetDriverParamDefaults lt WWPN gt lt Flag1 gt lt Flag2 gt Description Changes all values to the default for the adapter s Parameters WWPN World Wide Port Name of the adapter whose values you want to change to the default Flag1 L Make changes local for this adapter only G Make changes global all adapters on this host Flag2 P Make changes permanent persists across reboot
42. tion Shows a list of mapped targets and the LUNs for the port Parameters WWPN World Wide Port Name of the HBA whose target mapping you want to view HBAnyware Command Line User Manual Page 19 X EMULEX Version Supported by Windows Linux and VMware ESX Server Syntax hbacmd Version Description Shows the current version of the HBAnyware CLI Client application Parameters None Persistent Binding Commands Note The PersistentBinding SetPersistentBinding RemovePersistentBinding RemoveAllPersistentBinding BindingCapabilities BindingSupport and SetBindingSupport commands are not supported for Linux Note The PersistentBinding SetPersistentBinding RemovePersistentBinding RemoveAllPersistentBinding BindingCapabilities BindingSupport and SetBindingSupport commands exist in the Emulex driver for ESX Server 3 5 0 but are not supported Note In order for a binding to take effect immediately SetPersistentBinding parameter Scope or B the SCSIBus and SCSITarget must match the SCSI bus and SCSI target to which the FC target is already automapped If automapping is disabled the binding will take effect immediately if the FC target is not already persistently bound and the specified SCSIBus and SCS Target are available to be persistently bound Also the BindType must match the currently active bind type Otherwise you will be notified that you must reboot the system to cause the persistent binding to become ac
43. tive AllNodelnfo Supported by Windows Linux and VMware ESX Server Syntax hbacmd AllNodelnfo lt WWPN gt Description Shows target node information for each target accessible by the adapter Parameters WWPN World Wide Port Name of the adapter whose target node information you want to view BindingCapabilities Supported by Windows Syntax hbacmd BindingCapabilities lt WWPN gt Description Shows the binding capabilities present for the adapter If a binding is configured it means the binding is maintained across reboots Parameters WWPN World Wide Port Name of the adapter whose binding capabilities you want to view BindingSupport Supported by Windows Syntax hbacmd BindingSupport lt WWPN gt lt Source gt Description Shows the binding support available for the adapter HBAnyware Command Line User Manual Page 20 X EMULEX Parameters WWPN World Wide Port Name of the adapter whose binding support you want to view Source C Configuration support L Live support PersistentBinding Supported by Windows Syntax hbacmd PersistentBinding lt WWPN gt lt Source gt Description Specifies which set of persistent binding information is requested the configured or live state of any present binding Parameters WWPN World Wide Port Name of the adapter whose persistent binding information you want to specify Source C Configuration L Live SetPersistentBinding Supported by Windows
44. to hold I O error if the device disappears If this value is changed no driver reload is required scan_down 1 0 Off 1 On Selects method for scanning ALPA to assign a SCSI ID topology 0 0x0 loop Fibre Channel link topology then P2P defaults to loop if it fails 0x2 P2P only attempts point to point mode 0x4 loop only 0x6 P2P then loop use_adisc 0 0 Off 1 On Send ADISC instead of PLOGI for device discovery or RSCN If this value is changed no driver reload is required HBAnyware Command Line User Manual Page 35 X EMULEX Appendix C Driver Parameters for VMware All HBA specific parameters have an lpfcX_ prefix where X is the driver instance number e g setting IpfcO_lun_queue_depth 20 makes 20 the default number of maximum commands which can be sent to a single logical unit disk for Ipfc instance 0 Note NPIV is not available on 1 Gb s and 2 Gb s HBAs Dynamic parameters do not require the driver to be unloaded and reloaded for changes to take effect Table 4 Driver for VMware ESX Configuration Parameters Variable Default Min Max Dynamic Comments Ipfc_hba_queue_depth 65535 0 65535 Yes Maximum number of FCP commands that can queue to an Emulex adapter Ipfc_initiator_login Yes Enables logins to other virtual initiators Ipfc_ackO 0 Off 1 On No Use ACKO for class 2 Ipfc_automap 0 Off 1 On No Automatically assign
45. ue is set too low a performance degradation can occur due to driver throttling of its device queue Value 1 254 or 0x1 OxFE hex Default 32 0x20 HBAnyware Command Line User Manual Page 31 X EMULEX Table 2 Storport Miniport Driver Parameters Continued Parameter Definitions Activation Requirement QueueTarget n QueueTarget controls I O depth limiting on a per target or per LUN Dynamic basis If set to 0 depth limitation is applied to individual LUNs If set to 1 depth limitation is applied across the entire target Value 0 1 or 0x0 0x1 hex Default 0 0x0 RmaDepth n RmaDepth sets the remote management buffer queue depth The Reboot greater the depth the more concurrent management controls can be handled by the local node Value 8 64 or 0x8 0x40 hex Default 16 0x10 Note The RmaDepth driver parameter pertains to the functionality of the HBAnyware utility ScanDown n If set to 0 lowest AL_PA lowest physical disk ascending AL_PA Reboot order If set to 1 highest AL_PA lowest physical disk ascending SEL_ID order Value 0 1 Default 0 Note This option applies to private loop only in DID mode SLIMode n If set to 0 autoselect firmware use the newest firmware installed Reboot If set to 2 implies running the HBA firmware in SLI 2 mode If set to 3 implies running the HBA firmware in SLI 3 mode Value 0 2 and 3 Default 0 Topology n Topology values c
46. ver RPM for your Linux version Enter the following command all in one line rpm i elxlinuxcorekit version rpm VMware To install the HBAnyware CLI on a new system install the specific RPM for the driver for your VMware version Prerequisites The Ipfc driver must be loaded HBAnyware Command Line User Manual Page 1 X EMULEX Procedures To install the HBAnyware CLI 1 Log in as root 2 Copy the elxvmwarecorekit lt kit version gt rpm file to a directory on the install machine 3 CD to the directory to which you copied the rpm file 4 Install the rpm Type rpm U elxvmwarecorekit lt kit version gt rpm The rpm contents are installed in usr sbin hbanyware The hbacmd utility is also located in this directory Installing the HBAnyware CLI on a Linux System with an Existing HBAnyware CLI Kit Installed Follow these steps to install the HBAnyware CLI on a Linux system with an existing HBAnyware CLI kit installed 1 Uninstall the Linux core kit Type rpm e elxlinuxcorekit version Note If the uninstallation script does not work you have an older HBAnyware kit In this case follow the procedure for Uninstalling Older HBAnyware Kits on VMware in this topic 2 Install the specific RPM for your driver for Linux version Enter this command all in one line rpm i elxlinuxcorekit version rpm Uninstalling Older HBAnyware Kits on Linux 1 Locate and download the full application
47. ware FileName File name of the firmware image to load this can be any file accessible to the CLI client application HBAnyware Command Line User Manual Page 18 X EMULEX ExportSANInfo Supported by Windows Linux and VMware ESX Server Syntax hbacmd exportsaninfo format Note format is optional Leaving the format parameter blank will store the data in XML format Description For reporting purposes captures the HBA information in xml or csv format Parameters None GetVPD Supported by Windows Linux and VMware ESX Server Syntax hbacmd GetVPD lt WWPN gt Description Shows the port s Vital Product Data VPD Parameters WWPN World Wide Port Name of the HBA whose VPD you want to view ListHBAs Supported by Windows Linux and VMware ESX Server Syntax hbacmd ListHBAs Description Shows a list of the manageable Emulex adapters discovered by Fibre Channel in band and by TCP IP out of band Parameters None Reset Supported by Windows Linux and VMware ESX Server Syntax hbacmd Reset lt WWPN gt Description Resets the adapter An adapter reset can require several seconds to complete especially for remote devices Once the reset command is completed the system command prompt is displayed Parameters WWPN World Wide Port Name of the adapter you want to reset TargetMapping Supported by Windows Linux and VMware ESX Server Syntax hbacmd TargetMapping lt WWPN gt Descrip
Download Pdf Manuals
Related Search