Home

User Manual

1. sssssssssssseeenererrrirernnnnnnnnnnnnnnnnnnnnnnnnnnnnnn n 14 Using the CLI Client 14 SH IS Sh scene geste sees nen ee ese ste seen A E 14 The Command Reference eee aaa aaa a aaa a aaa aaa a aaaaee 16 Commands Not Supported in Linux and Solaris cccccssssssssseseeeteeeeees 16 Commands Not Supported in VMware EX 16 Commands Supported in CIM Interface 16 Commands Supported in Target mode Ports ssssssssssssssesssssssseeeeeees 18 Parameters Not Supported in the CIM Intertace 18 Read Only Mode 18 OneCommand Manager Command Line Interface User Manual Page iii Help Commande 19 elle EE 19 Adapter License Management Commandes ssssssessssessserrsssssserrrrnnsssrrennssens 19 InstallAdapterLiCensSe cccecccccceceeeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeteeeeeess 19 ShowAdapterLicenseFeatures eessessseesessssssrrtirrretsssrtrrrnntssssrtrnnnnnsssent 20 Show jcensehdapterlt 20 Attributes Commande snini aaa a aaa a a a E E E EENAA 21 HbaAttributes 00 0 cece ccc eeccceeeeceeeeceseeneeeeneneeneeeeneeseneeeeneeseneeseseeseaeeseneeees 21 league DC 21 ele LEE 22 ServerAttributes 0 0 ccceccceccseecceeceeeeeceeeeeeeeeeeeecaeaeeeeeueeeeeeeaeeeeeaeneeeeaaes 22 SL FTC MEMO E 22 SetPortEnabled ccc cccccecccccseeecceceeeeeececeeeceeecueueeceeeeeeeaeaeeeeeaeeeeeeaensseeeees 23 SetPhyPortSpeed oc eeececcceceeceeeneee esse ee eeneee sees tees eeeeecaaeeeeeeeeeteeedaeeeeeenee 23 Authenticatio
2. Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the port s Vital Product Data VPD Parameters WWPN Adapter s WWPN MAC MAC address of iSCSI or NIC port OneCommand Manager Command Line Interface User Manual Page 70 gt G EMULEX ListHBAs Supported by Windows Solaris Linux and VMware ESX Description This command shows a list of the manageable Emulex adapters found by local remote in band FC and remote out of band TCP IP discovery For a NIC only or iSCSI adapter the MAC address is displayed rather than the Port WWN The Node WWN and Fabric WWN are not displayed The type of information listed may vary according to the adapter model Syntax hbacmd h lt IPAddress gt listhbas local m model pt type Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Parameters h Host s IP address local Only display local adapters m model Model filter append to end of model name for wildcard match e g LP9 pt type Port type filter valid types NIC iSCSI FC FCoE RemoveHost Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd RemoveHost host_ad
3. Note Support for remote adapter is TCP IP access only The EchoTest command fails if the target WWPN does not support the ECHO ELS command Parameters WWPN Source WWPN of the originating adapter WWPN Destination WWPN of the destination echoing adapter Count Number of times to run the test 0 run test indefinitely StopOnError Checks if the test must be halted on error 0 No halt 1 Halt on error Pattern Hexadecimal data pattern to transmit up to 8 characters GetBeacon Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetBeacon lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the current beacon state ON or OFF OneCommand Manager Command Line Interface User Manual Page 34 gt G EMULEX Parameters WWPN WWPN of the FC port MAC MAC address of the NIC or iSCSI port GetXcvrData Note GetXcrvData is not supported for OneConnect OCe11100 series adapters Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetXcvrData lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This c
4. P Make changes permanent persists across reboot T Make changes temporary OneCommand Manager Command Line Interface User Manual Page 42 gt G EMULEX Dump Commands The diagnostic dump feature enables you to create a dump file for a selected adapter Dump files contain information such as firmware version driver version and operating system information for instance This information is useful when troubleshooting an adapter but is unavailable in read only mode Caution Disruption of service can occur if a diagnostic dump is run during I O activity The dump files created are binary files and text files txt The binary files have the following extensions depending on the adapter type e OneConnect CNAs edf extension e 16 Gb HBAs Din extension e Legacy and LightPulse adapters dmp extension DeleteDumpFiles Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd DeleteDumpFiles lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command deletes all diagnostic dump files for the adapter Parameters WWPN Adapter s WWPN MAC MAC address of the CNA port Dump Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd Dump lt WWPN MAC gt Note For managing ESX ESXi host
5. Hex binary Npw New password value Boot Commands Note Boot commands are supported on FC FCoE adapter ports only EnableBootCode Note This command is not supported for OneConnect adapters The boot code is always enabled on OneConnect adapters Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd EnableBootCode lt WWPN MAC gt lt Flag gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command enables or disables the boot code on the FC adapter or the Preboot Execution Environment PXE BIOS of the NIC on the CNA adapter If the boot code is disabled on the FC adapter the adapter does not boot from the SAN regardless of the value for the EnableBootFromSan boot param If the boot code is enabled on the FC adapter the adapter boots from the SAN if the EnableBootFromSan parameter is also enabled Disabling the PXE BIOS on the CNA adapter s NIC prevents booting from the NIC Enabling the PXE BIOS on the CNA adapter s NIC allows booting from the NIC Parameters WWPN Adapter s WWPN MAC The MAC address of the NIC or iSCSI port Flag D Disable the boot code E Enable the boot code GetBootParams Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetBootParams lt WWPN gt lt Type gt Desc
6. WWPN1 Adapter s WWPN WWPN2 Must be ff ff ff ff ff ff ff ff for a switch or the actual WWPN for a target GetAuthStatus Supported by Windows Solaris and Linux Syntax hbacmd GetAuthStatus lt WWPN1 gt lt WWPN2 gt Description This command returns the current status for the authentication connection specified by WWPN 1 and 2 adapter and the switch It includes the current authentication state connected or failed Currently authenticated connections specify the hash algorithm and DH group used in the DHCHAP associated with this connection Failed status includes the failure reason Parameters WWPN1 Adapter s WWPN WWPN2 Must be ff ff ff ff ff ff ff ff for a switch or the the actual WWPN for a target InitiateAuth Supported by Windows Solaris and Linux Syntax hbacmd InitiateAuth lt WWPN1 gt lt WWPN2 gt Description This command initiates the authentication configuration on the adapter Parameters WWPN1 Adapter s WWPN WWPN2 Must be ff ff ff ff ff ff ff ff for a switch or the actual WWPN for a target SetAuthConfig Supported by Windows Solaris and Linux Syntax hbacmd SetAuthConfig lt WWPN1 gt lt WWPN2 gt lt PasswordType gt lt Password gt lt Parameter gt lt Value gt Description This command sets the authentication configuration for the adapter OneCommand Manager Command Line Interface User Manual Page 25 gt G EMULEX Parameters WWPN1 Adapter s WWPN WWPN2 M
7. hbacmd CEEDownload lt WWPN gt lt Filename gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command updates the CEE firmware on the adapter Parameters WWPN Adapter s WWPN Filename Name of the file to download OneCommand Manager Command Line Interface User Manual Page 28 gt E EMULEX GetCEEParams Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetCEEParams lt WWPN gt Description This command shows the CEE parameters Parameters WWPN CNA s WWPN SetCEEParam Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetCEEParam lt WWPN gt lt Param gt lt Value gt Description This command sets or clears the Internal Host PFC flag SetCEEParam configures one of the CEE parameters Parameters WWPN World Wide Port Name of the adapter Param Parameter name LP21000 M and LP21002 M parameters Pausetype 1 Standard 2 Per Pause Priority pfcflag 0 Clear 1 Set pfcpriority 0 Oxff fcoepriority 0 7 fcoeformat 0 or 0x10000 Uifporttype 1 Access 2 Trunk Value Parameter Value Where multiple values are possible they should be specified using comma separated values OneCommand Manager Command Line Interface User Manual Page 29 gt G E
8. lt Target_IP gt port number lt Port gt and iSCSI name lt iscsi_target_name gt lf you do not specify the remaining options these options are set to their default values When you set the authentication method lt Auth gt to a value other than 0 you must set additional parameters to specify the initiator CHAP name target CHAP name and initiator and target secret strings Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser If you set the authentication method to One Way CHAP value of 1 you must also specify the Target CHAP Name and Target Secret Example hbacmd AddTarget 00 11 22 33 44 55 192 168 1 1 8000 iscsitarget Auth 1 TgtCHAPName TargetSecretl If you set the authentication method to Mutual CHAP value of 2 you must specify all 4 values Example hbacmd AddTarget 00 11 22 33 44 55 192 168 1 1 8000 iscsitarget Auth 1 TgtCHAPName TargtSecret1 InitCHAPName InitialSecret1 OneCommand Manager Command Line Interface User Manual Page 50 gt G EMULEX Parameters MAC_Address MAC address of the CNA port Port Port number of the target portal value 1024 65535 iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 Target_IP IP address of the target portal ImmediateData 0 No 1 Yes default 1 HeaderDigest 0 None 1 CRC32C default 0 DataDigest 0 None 1 CRC32C default
9. 0 Auth 0 None 1 One Way CHAP 2 Mutual CHAP default 0 TgtCHAPName Target CHAP name enclosed in quotes string length 1 256 TgtSecret Target Secret enclosed in quotes string length 12 16 InitCHAPName Initiator CHAP name enclosed in quotes string length 1 256 InitSecret Initiator Secret enclosed in quotes string length 12 16 Note If you set Auth to 1 you must also specify the TgtCHAPName and TgtSecret If you set Auth to a value of 2 you must also specify the TgtCHAPName TgtSecret InitCHAPName and InitSecret must also be specified AddTargetPortal Note You must specify either the TSIH value or the ISID qualifier If you specify ISID qualifier you must also specify the Target s ID address Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port AddTargetPortal lt MAC_Address gt lt Target_IP gt lt Port gt ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 0 1 gt Auth lt 0 1 2 gt TgtCHAPName TgtSecret InitCHAPName InitSecret OneCommand Manager Command Line Interface User Manual Page 51 gt G EMULEX Description This command adds a new SendTarget Portal for the initiator and runs a target discovery once the SendTarget Portal is created This command requires that you specify a valid portal IP address lt Target_IP gt and a valid port number lt Port gt If you do not specify the remaining options
10. 0 Get information from driver 1 Get information from configuration RescanLuns Supported by Windows and Solaris Syntax hbacmd RescanLuns lt HBA WWPN gt lt Target WWPN gt Description This command rescans LUNs to find any new LUNs Parameters HBA WWPN Adapter s WWPN Target WWPN Target s WWPN OneCommand Manager Command Line Interface User Manual Page 66 gt G EMULEX SetLunMask Supported by Windows and Solaris Syntax hbacmd SetLunMask lt HBA WWPN gt lt Target WWPN gt lt Option gt lt Lun gt lt LunCount gt lt MaskOp gt Description This command masks the specified LUNs Parameters HBA WWPN Adapter s WWPN Target WWPN Targets WWPN 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 AddHost Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd AddHost host_address Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command adds a host to the hosts file for TCP IP ma
11. Description This command 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 Parameters WWPN Adapter s WWPN 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 SCSlBus Bus number of the SCSI device SCSlTarget Target number of the SCSI device OneCommand Manager Command Line Interface User Manual Page 75 gt E EMULEX SetBindingSupport Supported by Windows and Solaris Syntax hbacmd SetBindingSupport lt WWPN gt lt BindFlag gt Description This command enables and sets the binding support s for the adapter Parameters WWPN Adapter s WWPN 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 SetPersistentBinding Supported by Windows and Solaris Syntax hbacmd SetPersistentBinding lt WWPN gt lt Scope gt lt BindType gt lt TargetId gt lt SCSIBus gt lt SCSITarget gt Description This command sets a persistent binding between an FC target and a SCSI Bus target The binding can be to a target WWPN target WWNN or target D_ID Parameters WWPN Adapter s WWPN Scope P Perm
12. DriverConfig Supported by Windows Linux and VMware ESX Syntax hbacmd DriverConfig lt WWPN gt lt FileName gt lt Flag gt Description This command sets all driver parameters to the values in the dpv file type The dpv file s driver type must match the driver type of the host platform adapter Parameters WWPN Adapter s WWPN FileName Name of the dpv file stored in the Emulex Repository directory Flag G Make change global all adapters on this host N Make change non global adapter specific GetDriverParams Supported by Windows Solaris Linux and VMware ESX 4 0 Syntax hbacmd GetDriverParams lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the name and values of each parameter Parameters WWPN Adapter s WWPN OneCommand Manager Command Line Interface User Manual Page 40 gt G EMULEX GetDriverParamsGlobal Supported by Windows Solaris Linux and VMware ESX 4 0 Syntax hbacmd GetDriverParamsGlobal lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the name and the global value of each driver p
13. VLAN_ID VLAN ID of the interface value 0 4095 Priority VLAN priority of the interface value 0 7 DHCP 0 Disabled 1 Enabled IP_Address New IP address for example 10 192 1 1 Subnet_Mask Subnet Mask for example 255 255 255 0 Gateway Gateway for example 10 192 1 1 Note VLAN_ID and Priority are required only if VLAN_ENABLED is enabled otherwise these values should be omitted Note ID Address and Subnet_Mask are required only if DHCP is disabled otherwise these values should be omitted OneCommand Manager Command Line Interface User Manual Page 58 gt G EMULEX SetTargetLoginProperties Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port SetTargetLoginProperties lt MAC_Address gt lt iscsi_target_name gt ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 0 1 gt Auth lt 0 1 2 gt TgtCHAPName TgtSecret InitCHAPName TnitSecret Description This command sets the login and authentication properties associated with a specific target This command requires that you specify a valid iSCSI target name lt iscsi_target_name gt If you do not specify some of the remaining properties these options are set to their default values However if no properties are changed an error is generated You must change at least one property for this command to return successfully When you set the authentication method
14. a priority group which has no other priorities 4 The FCoE priority must be assigned to a priority group which has no other priorities iSCSI Adapter Specific Rules 1 Minimum of one and a maximum of two PFC priorities can be configured 2 One of the PFC priorities must match iSCSI priority 3 The additional PFC priority must be assigned to a priority group which has no other priorities 4 The iSCSI priority must be assigned to a priority group which has no other priorities NIC Adapter Specific Rules 1 Only one PFC priority can be configured 2 The PFC priority must be assigned to a priority group which has no other priorities OneCommand Manager Command Line Interface User Manual Page 33 gt G EMULEX Parameters WWPN Adapter s WWPN MAC MAC address of the NIC or iSCSI port PFCPriorities PFC priority that is a comma separated list of up to 7 values ranging from 0 7 Priorities of PGID Priority group membership that is a comma separated list of priorities rang ing in value for 0 7 Example hbacmd h 10 192 203 151 m cim setdcbpriority 10 00 00 00 c9 3c f7 88 3 0 1 2 4 5 6 7 3000000 Diagnostic Commands EchoTest Note This command is not supported for OneConnect adapters Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd EchoTest lt WWPN Source gt lt WWPN Destination gt lt Count gt lt StopOnError gt lt Pattern gt Description This command runs the echo test on adapters
15. c9 5b 3a 6d fcmap O0x0efc99 OneCommand Manager Command Line Interface User Manual Page 48 gt G EMULEX iSCSI Commands Note iSCSI commands are supported only on OneConnect iSCSI ports Note VMware ESX 4 0 does not support iSCSI The following commands support the iSCSI interface in the OneCommand Manager CLI The commands and their syntax are listed here lt gt Required Optional The MAC address lt MAC_Address gt of the CNA port must be passed to each command as the first argument Some commands require values to be set in a format similar to opt ion_name value Type the full option name or the abbreviated option name shown in Table 1 Option Names on page 49 and enter the value The following abbreviations are available for use when setting the option name for a opt ion_name value option The abbreviations are not case sensitive Table 1 Option Names Option Name Abbreviation Example ImmediateData id id 1 DataDigest dd dd 1 HeaderDigest hd hd 1 Auth au au 1 Initiator_name in initiator name Initiator_alias ia ia initiator alias DHCP dh dh 1 VLAN_ENABLED ve ve 1 VLAN_ID vi vi 1 Priority pr pr 1 AddARPTableEntry Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port AddARPTablel lt Dest_MAC_Address gt lt Dest_IP_Address gt Entry lt MAC_Address gt De
16. gt lt password gt lt namespace gt lt portnum gt Note Use this command to set only the CIM credentials Once this is done subsequent hbacmd commands do not require you to specify the CIM credentials in the command line Description This command sets the default CIM credentials You must specify all four credentials username password namespace and portnumber Default credentials are used if any credential is not in the hbacmd command argument Once the default credentials for a host are set any other command can be issued by specifying m cim Parameters h Port s IP Address m cim username root Login User ID of the VMware ESX password Login password of the VMware ESX namespace Namespace where the Emulex provider is registered in the sfco CIMOM of VMware ESX specifically root emulex portnum Port number of the sfcb CIMOM listening to that is 5988 HTTP or 5989 HTTPS OneCommand Manager Command Line Interface User Manual Page 72 gt G EMULEX TargetMapping Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd TargetMapping lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows a list of mapped targets and the LUNs for the port Parameters WWPN Adapter s WWPN Version Supported by Win
17. gt G EMULEX OneCommand Manager Command Line Interface Version 6 0 User Manual Emulex Connects P007451 01A Rev A Servers Storage and People gt G EMULEX Copyright 2011 Emulex All rights reserved worldwide No part of this document may be reproduced by any means or translated to any electronic medium without the prior 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 copyright or related rights of Emulex Emulex the Emulex logo AutoPilot Installer AutoPilot Manager BlockGuard Connectivity Continuum Convergenomics Emulex Connect Emulex Secure EZPilot FibreSpy HBAnyware InSpeed LightPulse MultiPulse OneCommand OneConnect One Network One Company SBOD SLI and VEngine 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 an
18. host_IP port hostname port RemoveTarget lt MAC_Address gt lt iscsi_target_name gt Description This command removes the target with the specified iSCSI target name lt iscsi_target_name gt Parameters MAC_Address MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 RemoveTargetPortal Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port RemoveTargetPortal lt MAC_Address gt lt Target_IP gt lt Port gt Description This command removes the SendTarget Portal containing the target IP lt Target_IP gt and the port lt Port gt from the list of portals for the specified initiator Parameters MAC_Address MAC address of the CNA port Target_IP IP address of the target portal Port Port number of the Target portal value 1024 65535 OneCommand Manager Command Line Interface User Manual Page 56 gt G EMULEX SetlnitiatorProperties Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port SetInitiatorProperties lt MAC_Address gt Initiator_Name initiator_name Initiator_Alias initiator_alias ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 0 1 gt Auth lt 0 1 2 gt TgtCHAPName TgtSecret InitCHAPName TnitSecret Description This command sets the initiator properties for the specified port It allows you to
19. information and details on using the OneCommand Manager CLI see Using the CLI Client on page 14 Compatibility See the Emulex website for supported operating systems and platforms New Features in this Release Support for Emulex multi ASIC OneConnect adapters e Support for Emulex 16 Gb s host bus adapters New Commands The following new commands are supported in OneCommand Manager CLI e Attributes Commands e SetPhyPortSpeed Installing the OneCommand Manager CLI In Windows There are two ways to install the OneCommand Manager CLI in Windows e Attended installation e Unattended installation Attended Installation in Windows To install the OneCommand Manager CLI run the installation exe file for a core Windows driver kit that does not include the OneCommand Manager GUI and follow the installer directions e elxocmcore windows lt arch gt lt kit version gt exe lt arch gt is either x64 or x86 lt kit version gt represents the complete version For example elxocmcore windows x64 5 0 2 14 1 exe Note For Itanium 64 systems install the x86 kit OneCommand Manager Command Line Interface User Manual Page 1 gt G EMULEX Unattended Installation in Windows To install the OneCommand Manager CLI application in Windows 1 From the Emulex website download the x64 or x86 OneCommand Manager Core Kit installation file to your system 2 Atthe command prompt set the optional switch to q or q2 The k
20. system before trying to access the adapter on that system For information on rebooting the ESX system refer to VMware documentation Note For ESX COS If you are using the CIM interface to access adapters after changing the WWN of an adapter you must restart the CIMOM that is SFCB on the ESX COS system before trying to access the adapter on that system For information on restarting the CIMOM refer to VMware documentation Parameters WWPN Adapter s WWPN Type 0 Restore Default WWNs 1 Restore NVRAM WWNs OneCommand Manager Command Line Interface User Manual Page 82
21. the FfcThrottle state as enabled or disabled OneCommand Manager Command Line Interface User Manual Page 22 gt G EMULEX Parameters WWPN Adapter s WWPN PfcThrottle state 0 for Disable 1 for Enable SetPortEnabled Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetPortEnabled lt WWPN MAC gt lt PortEnable gt Description This command enables or disables the FC or CNA port Parameters WWPN Adapter s WWPN MAC MAC address of the NIC or iSCSI port PortEnable 0 for Disable 1 for Enable Note Ensure all I O on the port is stopped before disabling the port Note When the SetPortEnabled command disables an FC port the adapter must be reset to activate the new setting Only OneConnect adapters do not require a reset when the adapter port is enabled or disabled SetPhyPortSpeed Note The SetPhyPortSpeed command is available in OneConnect OCe11102 adapters only Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetPhyPortSpeed lt WWPN MAC gt lt Mode gt Speed Length Description This command sets the port speed on OneConnect OCe11102 adapters Parameters WWPN Adapter s WWPN MAC MAC address of the NIC port Mode Mode number 0 for Default 1 for Auto Negotiate 2 for Force OneCommand Manager Command Line Interface User Manual Page 23 gt G EMULEX Speed Speed string that is required for Mode 1 or 2 Length DAC cable l
22. volatile or non volatile state of WWNs If the volatile change is requested on an adapter that does not support volatile WWNs it returns a not supported error Note When a volatile change is supported a reboot is required to activate the new setting Volatile names are active until system power down or adapter power cycle OneCommand Manager Command Line Interface User Manual Page 80 gt G EMULEX Note For VMware ESX 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 the subsequent boot may take a long time Note For VMware ESX After changing the WWN of an adapter you must reboot the ESX system before trying to access the adapter on that system For information on rebooting the ESX system refer to VMware documentation Note For ESX COS If you are using the CIM interface to access adapters after changing the WWN of an adapter you must restart the CIMOM that is SFCB on the ESX COS system before trying to access the adapter on that system For information on restarting the CIMOM refer to VMware documentation Parameters WWPN Adapter s WWPN New WWPN New adapter s WWPN New WWNN New adapter s WWNN Type 0 Volatile 1 Non Volatile GetWWNCap Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetWWNCap lt WWPN gt Note For managing ESX ESXi hosts
23. you set Auth to a value of 2 you must specify the TgtCHAPName TgtSecret InitCHAPName and InitSecret SetTargetProperties Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port SetTargetProperties lt MAC_Address gt lt iscsi_target_name gt lt ETO gt Description This command sets the Extended TimeOut ETO value of a target This command requires you specify the iSCSI target name lt iscsi_target_name gt and the Extended Timeout lt ETO gt values Parameters MAC_Address MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 ETO Extended Timeout Option for the target value differs depending on the OS Windows 0 3600 Solaris Linux and ESX 0 30 SetTPLoginProperties Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port SetTPLoginProperties lt MAC_Address gt lt Target_IP gt lt Port gt ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 0 1 gt Auth lt 0 1 2 gt TgtCHAPName TgtSecret InitCHAPName InitSecret Description This command sets a target portal s login properties This command requires that you specify a valid Target IP lt Target_IpP gt and Port lt Port gt However if you specify no options other than the Target IP and Port no changes are made You must change at least one of the optional parameters for th
24. 0 TgtCHAPName Target CHAP name enclosed in quotes string length 1 256 TgtSecret Target Secret enclosed in quotes string length 12 16 InitCHAPName Initiator CHAP name enclosed in quotes string length 1 256 InitSecret Initiator Secret enclosed in quotes string length 12 16 Note If you set Auth to 1 you must specify the TgtCHAPName and TgtSecret If you set Auth to a value of 2 you must specify the TgtCHAPName TgtSecret InitCHAPName and InitSecret ShowARPTable Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port ShowARPTable lt MAC_Address gt Description This command shows the current Address Resolution Protocol table for the specified port Parameters MAC Address MAC address of the CNA port OneCommand Manager Command Line Interface User Manual Page 61 gt G EMULEX ShowiSNSServer Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port ShowiSNSServer lt MAC_Address gt Description This command shows the currently configured Internet Storage Name Server This command also indicates whether or not iSNS discovery is enabled Parameters MAC Address MAC address of the CNA port ShowRouteTable Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port ShowRouteTable lt MAC_Address gt Description This command shows the route table for a s
25. 0 x For RHEL5 5and later and SLES10 SP3and later operating systems e Linux driver version 8 3 5 x For RHEL6 and later and SL11 SP1 and later operating systems On OneConnect iSCSI adapters e be2iscsi driver On OneConnect NIC adapters e be2net driver The be2net driver must also be installed if the adapter personality is iSCSI NIC or FCoE NIC Use the latest or matching driver from the Emulex website Note The OneCommand Manager core kit cannot be installed if a previous version of the HBAnyware utility is installed Procedures You have two options when installing the OneCommand Manager CLI on a Linux system e Upgrade preserve existing settings e Clean install overwrite existing settings Upgrading Follow these steps 1 You must install the current core kit as detailed in installing the OneCommand Manager CLI In Linux on page 3 The rpm file handles the configuration file upgrade The install script executes an rom upgrade rpm U rpm to upgrade the installed version of the core kit to the current version OneCommand Manager Command Line Interface User Manual Page 4 gt G EMULEX Note There is no upgrade path from an HBAnyware 4 x or 3 x core kit to a OneCommand Manager 5 1 or later core kit You must un install previous versions of the HBAnyware utility before installing a OneCommand Manager core kit For information on uninstalling older versions of HBAnyware see Uninstalling Older HBAnywa
26. 3 2 3 68 lt arch gt rpm or later The PPC64 and x86_64 builds require the 64bit version installed which is installed in usr lio64 The i386 build requires the 32bit version installed which is installed in usr lib On OneConnect NIC adapters e The NIC driver e The NIC driver must also be installed if the adapter personality is iSCSI NIC or FCoE NIC Use the latest or matching driver from the Emulex website Procedures To install the OneCommand Manager CLI Copy the applications kit tar file to a directory on the installation machine Change to the directory where you copied the tar file Untar the file tar zxvf elxocmcore lt supported_os gt lt app_ver gt lt rel gt tgz 4 Change use cd command to the core kit directory created in step 3 cd elxocmcore lt supported_os gt lt app_ver gt lt rel gt 5 Run the install sh script install sh OneCommand Manager Command Line Interface User Manual Page 3 gt G EMULEX Note The core kit consists of 2 rpm files for each supported architecture and each supported version of Linux 1 elxocmlibhbaapi rpm on 64bit platforms that support 32 bit apps there will be 2 of these 2 elxocmcore rpm In Linux with an Existing OneCommand Manager CLI Kit Prerequisites For existing systems the following must be installed before installing the OneCommand Manager CLI On LP21000 series adapters and OneConnect FCoE adapters e Linux driver version 8 2
27. 6 GetLUnUnMaskBy larget sssseeeeeessssirrrssssserirrrrsttssrnrnrnnnnssstnnnnnnnnssennnnn 66 EECH Deche ke ec em T 66 Get unMaek eee eeececee eset eee eeccaaeeeeeeeeeeeeeaaeeeeeeeeeeeeenaaeeeeeeenenee 67 Miscellaneous Commande sssssssseieeessssssrrrtssssrtirrnttssstnnnnnnnssstnnnnnnnnnernnnnn 67 EE EE eege 67 GC naGlearE Vent OG EE 68 CnatG eiEvent og 68 OneCommand Manager Command Line Interface User Manual Bell le EE 68 EXpOrtSANInfo oo eeeeeeeceeneee cece ee eeeeeceaeeeeeeeeeeeeeaaaaeeeeeeeeeeeeccaaeeeeeeeeeeeeenaaaes 69 TVG une EE 69 GetElxSeclnfo ce eeeeeeeeee eee cecceeee eee e eee eeeccaaeeeee eee eeeceaaeeeeeeeeeteeedaaeeeeeeeeeneed 70 KOLO INT E 70 T AA nd D ee eee 70 MENS TPES PAS covets oak act es ches vie ace eh ek vac acters EA E ah ea shah eeate ss 71 Hemovetiost uk 71 PROS OU ays E E A E A A E E E E TT 72 Det ImtCred eset ee eeeecaaeeeeeeeeegecccaaeeeeeeeeseeeedaeeeeeeeeeenee 72 NET ge deele Te E rrerererr rr rrr rrerrrerrerrrrrrrrrrrerrreerrrrrrrrrerrerrrer renner 73 KLL A E E E E 73 Persistent Binding CommandS ccceeeeeeeeeeeeeeeeeeeeeccneeeeeeeeeeteeenaeeeeeeeeettees 73 Allee ut RA 74 Gleis e Ee 74 BindingSupport a eee eee 74 Pec ISTO IEE IIIA WEE 74 RemoveAllPersistentBinding ccccccceceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 75 RemovePersistentBinding Aus 75 SetBindingSupport cece eeceeee cece eee eeeeeeee sees eeeeeceaaaeeeeeeeeeeeeedaeeeeeeeeeeteed 76 S
28. BAnyware or OneCommand Manager CLI installed 1 Install the rpm file by entering the following command on one line rpm Uvh elxocmcor sxNN lt kit version gt lt arch gt rpm NN is 40 for an ESX 4 0 system 41 for an ESX 4 1 system and 50 for an ESXi 5 0 system OneCommand Manager Command Line Interface User Manual Page 2 gt G EMULEX In Linux Prerequisites For new systems the specific driver rpm file for your Linux version must be installed Note On RHEL 5 5 and later and RHEL 6 and later the OneCommand Core rpm file requires the Libnl library This library is not installed by default but can be obtained from the OS distribution media e Fori386 RHEL 5 5 RHEL 5 6 and RHEL 6 use the 32bit libnl library e For x86_64 RHEL 5 5 RHEL 5 6 and RHEL 6 use the 64bit libnl library e For ia64 RHEL 5 5 RHEL 5 6 and RHEL 6 use the 64bit libnl library e For PPC RHEL 5 5 RHEL 5 6 and RHEL 6 use the 32bit libnl library For existing systems the following must be installed before installing the OneCommand Manager application CLI On LP21000 series adapters and OneConnect FCoE adapters e Linux driver version 8 2 0 33 3p or later For RHEL5 and SLES10 operating systems e Linux driver version 8 3 5 X for RHEL6 and later and SLES 11 SP1and later operating systems Note The RHEL 6 Enterprise kit requires the intallation of the libstdc 5 so library This library is available through the compat libstdc 33
29. C ports being managed locally or remotely managed through TCP IP based management Parameters WWPN WWPN of the FC or FCoE port MAC MAC address of the NIC or iSCSI port Type Type of loopback test to run 0 PCI LoopBack Test 1 Internal LoopBack Test 2 External LoopBack Test requires loopback plug 3 DMA Loopback Test 4 PHY Loopback Test 5 MAC Loopback Test Note Loopback tests 0 and 1 are not supported for OneConnect adapters Loopback tests 3 4 and 5 are only supported for OneConnect adapters Count Number of times to run the test 0 run test infinitely Range 1 99 999 StopOnError Checks if the test must be halted on error 0 No halt 1 Halt Pattern optional 1 to 8 hexadecimal bytes to use for loopback data for example 1a2b3c4d Example hbacmd h 10 192 193 154 m cim u root p Swamiji001 n root emulex loopbacktest 00 00 c9 93 2f 9f 4 120 0 LoopMap Note Supported for FC ports only Supported by Windows Solaris and Linux Syntax hbacmd LoopMap lt WWPN gt Description This command shows the arbitrated loop map data OneCommand Manager Command Line Interface User Manual Page 36 gt G EMULEX Parameters WWPN Adapter s WWPN PciData Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd PciData lt WWPN MAC gt lt Type gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The de
30. Connect adapter parameters doe not apply to LP21xxx adapters DCBXState The current DCBX Data Center discovery and Capability exchange protocol state DCBXMode The DCBX mode can be either DCB or CIN Note DCBX mode also configures FIP mode If DCBX mode is DCB FIP is enabled If it is CIN FIP is disabled OneCommand Manager Command Line Interface User Manual Page 31 gt G EMULEX PFCEnable Enabled means that flow control in both directions Tx and Rx is enabled FCoEPriority You must specify a single priority 0 7 only for FCoE adapters iSCSIPriority You must specify a single priority 0 7 only for iSCSI adapters PFCPriorities Specify PFCPriorities as a single priority or as a list of comma separated val ues Comma separated list of up to 7 values ranging from 0 7 Default Setting the SetDCBParam arguments to default sets all CNA DCB params includ ing priority groups to their default values For example hbacmd SetDCBParam lt WWPN MAC gt defaults Link Layer Discovery Protocol LLDP parameters 1 enabled 0 disabled TxState Transmit State DCBX uses Link Layer Discovery Protocol LLDP to exchange parameters between two link peers For the DCBX protocol to operate correctly both LLDP Rx and Tx must be enabled If either Rx or Tx is disabled DCBX is disabled RxState Receive State DCBX uses LLDP to exchange parameters between two link peers For the DCBX protocol to operate correc
31. EtPeSrsiStentBindiAGQsascscccczesesecnesseveseseseseaneesesesepesessaneesesesesesevsaereseatsenaasaaes 76 Personality Change Commande 77 Change Personality rannira a iaaa 77 ShowPersonalitieS cceececceceeeee eee eeeeecceeeeeeeeeeeeeeaaeeeeeeeeeeeeedaaeeeseeeeeneed 78 Virtual Port VPort Commande ssesseeeeeeeseeeeesessssrirnrrsssssrrrnnnnnsssrtnnnnnnnssent 78 Create V POS cccceceeeeeeeeeeeeccneee sees ee eeeceaaaeeeeeeeeeeeccaaaeeeeeeeeegeeedaaeeeeeeeeeteed 78 ele Ee 79 EISE 79 BC IC 80 KAS rg re cstctaccest E 80 WWN Management Commandes sssssssssssseeiesssssiirrssssesirrnntnsssstrnnnnnnsssrrnnnn nnn 80 ChangeWwWN eee eeeeeeccaaeeeeeeeeeeeccaaeeeeeeeeegeeedaaeeeeeeeennee 80 GeWWNC ap 81 HeadWwWN EE 81 FROSTOLE VW VN EE A T EE 82 OneCommand Manager Command Line Interface User Manual Page vi gt G EMULEX Introduction The OneCommand Manager Command Line Interface CLI is a comprehensive management utility for Emulex host bus adapters HBAs and converged network adapters CNAs The CLI provides support for commonly used commands without requiring installation of the OneCommand Manager Graphical User Interface GUI The OneCommand Manager CLI console application name is HbaCmd and can be installed on Windows Solaris Linux and versions of VMware ESX that include a Console Operating System COS A single operation is performed by entering hbacmd followed by the command at the command line For syntax
32. MULEX Data Center Bridging Commands Note Data Center Bridging DCB commands are for DCB management of OneConnect adapters only GetDCBParams Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetDCBParams lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the Internal Host PFC flag value and DCBX mode DCB version as well as the LLDP state for iSCSI FCoE and NIC CNAs Parameters WWPN Adapter s WWPN MAC MAC address of the NIC or iSCSI port Example hbacmd h 10 192 203 154 getdcbparams 00 00 c9 93 2f d8 GetPGInfo Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetPGInfo lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the bandwidth percentages for all the priority groups for the port Additionally this command displays the number of priority groups supported by an adapter Parameters WWPN The WWPN address of the FCoE port MAC MAC address of the NIC or iSCSI port Example hbacmd h 10 192 203 154 getpginfo 00 00 c9 93 2f d8 OneCommand Manager Command Line Interface Us
33. Min Max r VLAN ID Bandwidth Bandwidth Supported FC4 00 00 01 20 00 00 Acti 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ve FC4 00 00 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Max Frame Size 2048 OS Device Name Num Discovered Ports 0 Fabric Name 00 00 00 00 00 00 00 00 OneCommand Manager Command Line Interface User Manual 00 00 00 01 00 01 00 00 00 gt S EMULEX Emulex Util OCManager gt hbacmd h 10 192 113 128 m cim u root p root n root emulex portattributes 10 00 00 00 c9 6b 62 2b Page 12 gt G EMULEX If you specify the parameter m cim the CLI uses the CIM interface to talk to the CIM server running on ESX to get the management information If you do not specify the parameter m cim the CLI uses the RM interface to talk to the RM server to get the management information OneCommand Manager Command Line Interface User Manual Page 13 gt G EMULEX The CLI Client Command Reference Using the CLI Client Syntax Rules The syntax rules for HoaCmd are as follows e All commands must start with hbacmd in lowercase in Linux Solaris and VMware which are 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 usin
34. Page 47 gt G EMULEX GetFIPParams Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetFIPParams lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command gets the FIP parameters of the OneConnect adapter in FCoE mode Parameters WWPN Adapter s WWPN Example hbacmd getfipparams 10 00 00 00 c9 5b 3a 6d SetFIPParam Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetFIPParam lt WWPN gt lt Param gt lt Value gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command sets the FIP parameters of the OneConnect adapter in FCoE mode Parameters WWPN Adapter s WWPN Param FIP parameter name The five parameters are pfabric pswitch vlanid femap and cinv lanid Value FIP parameter value and the valid range for the FIP parameter pfabric 8 byte fabric name format XX XX XX XX XX XX XX XX pswitch 8 byte switch name format XX XX XX XX XX XX XX XX vlanid 2 byte VLAN ID 0 4095 OR any for any VLANID femap 3 byte EC map 0OxOEFCxx cinvlanid 2 byte VLAN_ID 0 4095 Example hbacmd setfipparam 10 00 00 00
35. X 4 0 4 1 or ESXi 5 0 COS does not support management of adapters using the CIM interface gt G EMULEX For example run the following command to display a list of adapters managed for a specified host using CIM interface In Windows C Program Files I p root n root emulex listhbas Note In Linux VMware and Solaris you cannot use hbacmd as a CIM client The output displayed is similar to the following Manageable HBA List Port WW Node WW Fabric Flags Host Nam Mfg Serial Port Num 10 00 00 00 c9 6b 62 2b 20 00 00 00 c9 6b 62 2b ame 00000000 00 00 00 00 00 00 00 00 O ber ng ma emulex com Emulex Corporation BG73539764 n a OneCommand Manager Command Line Interface User Manual Emulex Util OCManager gt hbacmd h 10 192 113 128 m cim u root Page 11 Mode Initiator Discovery cim Port WW Node WW 10 00 00 00 c9 6b 62 59 20 00 00 00 c9 6b 62 59 Fabric Name 00 00 00 00 00 00 00 00 Flags 00000000 Host Nam ng ma emulex com Mfg Emulex Corporation Serial No BG73539764 Port Number n a Mode Initiator Discovery cim C Program Files I Port Attributes for 10 00 00 00 c9 6b 62 2b Node Port Port Port Port Port Port vNIC vNIC vNIC vNIC Port Port WWN 20 00 00 00 c9 6b 62 2b WWN 10 00 00 00 c9 6b 62 2b Symname FCID 0000 Type Fabric State Unknown Service Type 12 Name Oute
36. Xi hosts gt hbacmd h lt IP_Address gt m cim u root p lt password gt n lt namespace gt ShowLicenseAdapterID 00 12 34 56 78 9A Attributes Commands HbaAttributes Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h lt IPAddress gt hbaattributes lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows a list of all adapter attributes for all ports on the adapter The type of information listed may vary according to the adapter model Parameters h Host s IP address WWPN WWPN of the adapter PortAttributes Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd lt h IPAddress of host gt PortAttributes lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows a list of all port attributes for the adapter The type of information listed may vary according to the adapter model Parameters h Host s IP address WWPN Port s WWPN MAC MAC address of the NIC or iSCSI port OneCommand Manager Command Line Interface User Manual Page 21 gt G EMULEX PortStatistics Supported by Windows S
37. ameter set OneCommand Manager Command Line Interface User Manual Page 41 gt G EMULEX SetDriverParam Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetDriverParam lt WWPN gt lt Flagl gt lt Flag2 gt lt Param gt lt Value gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command changes a driver parameter and designates the scope of the change Parameters WWPN Adapter s WWPN 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 parameter value decimal or hex Oxnnn SetDriverParamDefaults Supported by Windows Linux and VMware ESX Syntax hbacmd SetDriverParamDefaults lt WWPN gt lt Flagl gt lt Flag2 gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command changes all values to the default for the adapter s Parameters WWPN Adapter s WWPN Flag1 L Make changes local for this adapter only G Make changes global all adapters on this host Flag2
38. anae sane vauneshanocenausvarscsueushanavannyasabecauneshanounansbabacsuevabanasamneas 38 EE DEE EE 38 SetCableNvP ccccccccccsseccceceeeceeeeeeceeceeueeeeeeeeeeeeaeeceeeeeueeeeeeeeeeeaeeeeeeaaes 39 WY SUID ae aac E E T N 39 Driver Parameter Commande 40 DriverConfig ccccccceeeeeeeeceneeeeeeeeeeeeecaeeeeeeeeeeeeeeaaaeeeeeeeeeeeccqceeeeeeeeeteeenaaaes 40 GetDriverParamsS cccccceeccccceeeccecceeeceeceeseeeeeeeeeeecaeeeeecaeeeeeeeeeeeeeaeneeenaaes 40 GetDriverParaMSGlobal ccccccccseccceceeecceeeeeceeceeseceecaeeeeeeeeeeeeeeaeeeeeeaaes 41 En EE 41 Se tDriverParaM eai a a a a E 42 OneCommand Manager Command Line Interface User Manual Page iv Gettitverbaramietaults 42 DUMP Commande eee e eee eteecaaeeeeeee ee teeccaaaeeeeeeeeesecedieeeeeeeeentees 43 DeleteDUIMPPFileS ss sszsissssciessscheienaiehehensnehthansnehihananshibananshshananehshanauanananazandis 43 Blue SE 43 GeLDUMPDINGCLORY sirarsa aE EEA EA A Aa 44 SetDumpDirectory ee e eee ceeeee cece eee eeeeceee eset eee eeeeaaaeeeeeeeeeeeeecaaaeeeeeeeenteea 44 EE RIIT 45 GeiDumptlehames 46 GetRetentionCount ssssssessssrrrssssssrrnrsssrrrernnttsstsssernrnnnnnnssernnnnnnnnnnnnnnnn 46 GetieientiontCount 47 R nn ET EE 47 GetFCFINGO sisri aaa aaaea a a EER ERS 47 EE E E EE 48 SetFIPParam ssssssseesssunssesssesssnrrssssssssnessressnnnsnnnssesotsrsnnnnssceetnnennnssreennnes 48 Eeer E EE 49 AddARP Table Entry lll nnn nl ln nn ln ni il lillie
39. and VMware ESX Syntax hbacmd ListVPorts lt physical WWPN gt Description This command lists virtual ports on the specified physical port Leaving the physical WWPN parameter blank lists all virtual ports on all manageable hosts that support virtual ports Parameters Physical WWPN Adapter s WWPN VPortTargets Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd VPortTargets lt physical WWPN gt lt virtual WWPN gt Description This command lists targets visible to the specified virtual port Parameters Physical WWPN Adapter s WWPN Virtual WWPN The WWPN of the virtual port WWN Management Commands Note Supported for FC FCoE adapter ports only Note WWN Management validates WWNs carefully to avoid name duplication Therefore you may see error and warning messages if a name duplication is detected Emulex strongly recommends 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 Solaris Linux and VMware ESX Syntax hbacmd ChangeWWN lt WWPN gt lt New WWPN gt lt New WWNN gt lt Type gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command changes the
40. anent binding survives reboot Immediate binding B Binding is both permanent and immediate BindType P Enable binding by WWPN N Enable binding by WWNN D Enable binding by D_ID Targetld Target WWPN if BindType P Target WWNN if BindType N Target D_ID if BindType D OneCommand Manager Command Line Interface User Manual Page 76 gt G EMULEX SCSIBus Bus number of the SCSI device SCSITarget Target number of the SCSI device Personality Change Commands TheOneCommand Manager application enables you to change the personality or protocol running on OneConnect adapters When you change the personality of the adapter and reboot the host the adapter starts running the new personality or protocol The personalities that OneConnect adapters currently run are NIC only NIC FCoE and NIC iSCSI In some cases the adapters are pre configured to support multiple personalities In other cases you must install a license key before the adapter can support multiple personalities See Adapter License Management Commands on page 19 for more information Note The three different personalities may not always be available on an adapter For example a NIC FCoE adapter can change to a NIC only or a NIC iSCSI adapter but an ISCSI adapter may not be able to change to a NIC FCoE adapter Note It is possible to install one or more driver kits for the current personality then change the personality and no longer have the
41. arameter Parameters WWPN Adapter s WWPN SaveConfig Note Driver parameters that are set temporarily and globally using the G and T flags must be read using the GetDriverParams hbacmd command to view the current value of the parameter The GetDriverParamsGlobal hbacmd command returns only permanently set driver parameter values Additionally if temporary global values have been set for one or more driver parameters the SaveConfig hbacmd command must be run with the N flag using the N flag is analogous to the hbacmd command GetDriverParams to force the driver parameter values for the specified adapter to be saved Inaccurate values may be saved if the G flag is used for this command Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SaveConfig lt WWPN gt lt FileName gt lt Flag gt Description This command 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 The command saves either the values of the global set or those specific to the adapter in the Emulex Repository directory Parameters WWPN Adapter s WWPN FileName Name of the file that contains the driver parameters list Flag G Save the global parameter set N Save the local adapter specific par
42. closed in quotes string length 12 16 Note If Auth is set to 1 the TgtCHAPName and TgtSecret must be specified If Auth is set to a value of 2 the TgtCHAPName TgtSecret InitCHAPName and InitSecret must also be specified OneCommand Manager Command Line Interface User Manual Page 52 gt G EMULEX CleariSNSServer Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port CleariSNSServer lt MAC_Address gt Description This command clears the configured iSNS server and disables iSNS target discovery If there is no iSNS server currently configured this command does nothing Parameters MAC_ Address MAC address of the CNA port DelARPTableEntry Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port DelARPTableEntry lt MAC_Address gt lt Dest_MAC_Address gt lt Dest_IP_Address gt Description This command removes an ARP Address Resolution Protocol table entry Parameters MAC_ Address MAC address of the CNA port Dest_MAC_Address Destination MAC address to remove from the ARP table Dest_IP_Address Destination IP address to remove from the ARP table DelRouteTableEntry Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port DelRouteTableEntry lt MAC_Address gt lt Dest_IP_Address gt lt Subnet_Mask gt lt Gateway gt Description This command removes a route tab
43. ddress MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 TSIH TSIH value of the session value 1 65535 ISID_Qual ISID qualifier of the session value 0 65535 Target_IP The Target s IP address Note You must specify either the TSIH value or the ISID qualifier If ISID qualifier is specified you must also specify the Target s ID address iSCSIPing Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port iSCSIPing lt MAC_Address gt lt IP_Address gt Description This command issues ICMP echo requests to a target Parameters MAC_Address MAC address of the CNA port IP_Address IP address of target to send ICMP echo request OneCommand Manager Command Line Interface User Manual Page 55 gt G EMULEX ListSessions Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port ListSessions lt MAC_Address gt lt iscsi_target_name gt Description This command lists all the sessions on a specified target The iSCSI target name lt iscsi_target_name gt instructs the command to gather the information from the listed iSCSI target name Parameters MAC_Address MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 RemoveTarget Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h
44. default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command displays the list of licensed and licensable features as well as features that are already licensed The output is a list of features with an indication of whether or not the feature has been licensed Parameters WWPN Adapter s FCoE port WWPN MAC Adapter s NIC or iSCSI port address Example For non ESxi hosts hbacmd ShowAdapterLicenseFeatures 00 12 34 56 78 9A For ESXi hosts hbacmd h lt IP_Address gt m cim u root p lt password gt n lt namespace gt ShowAdapterLicenseFeatures 00 12 34 56 78 9A ShowLicenseAdapterID Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd ShowLicenseAdapterID lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command returns the adapter ID used for enabling licensed features The adapter ID and the entitlement code are used to obtain license keys which enable various features on the adapter OneCommand Manager Command Line Interface User Manual Page 20 gt G EMULEX Parameters WWPN Adapter s FCoE port WWPN MAC Adapter s NIC or iSCSI port address Example For non ESXi hosts gt hbacmd ShowLicenseAdapterID 00 12 34 56 78 9A For ES
45. dows Solaris Linux and VMware ESX Syntax hbacmd Version Description This command shows the current version of the OneCommand Manager CLI Client Parameters None Persistent Binding Commands Note Supported for FC FCoE ports only Note Not supported on Linux Solaris or VMware ESX PersistentBinding SetPersistentBinding RemovePersistentBinding Remove All Persistent Binding BindingCapabilities BindingSupport and SetBindingSupport 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 takes 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 are notified that you must reboot the system to cause the persistent binding to become active OneCommand Manager Command Line Interface User Manual Page 73 gt G EMULEX AllNodelnfo Supported by Windows Solaris and Linux Syntax hbacmd AllNodeInfo lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command show
46. dress Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command removes a host from the hosts file use for TCP IP management in the OneCommand Manager application GUI The host_address can be an IP address using the IPv4 or IPv6 format or a host name Parameters host_address Host to remove OneCommand Manager Command Line Interface User Manual Page 71 gt G EMULEX Reset Note Supported only for FC and FCoE ports Not supported for NIC and iSCSI ports Note For OneConnect FCoE ports this command only resets the driver to update changed driver parameters that require a driver reset It does not cause a hardware reset of the adapter port Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd Reset lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command resets the adapter An adapter reset can require several seconds to complete especially for remote devices When the reset is completed the system command prompt is displayed Parameters WWPN Adapter s WWPN SetCimCred Supported by VMware Syntax hbacmd SetCimCred lt username
47. dress gt lt Target_IP gt lt Port gt Description This command shows the properties for a specified SendTarget Portal If the Target_IP and Port are not specified all SendTarget Portals and their associated properties return Parameters MAC Address MAC address of the CNA port Target_IP IP address of the target portal Port Port number of the target portal TargetLogin Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port TargetLogin lt MAC_Address gt lt iscsi_target_name gt target_portal_ip lt port gt ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 0 1 gt Auth lt 0 1 2 gt TgtCHAPName TgtSecret TnitCHAPName InitSecret Description This command logs in to a target The iSCSI target name lt iscsi_target_name gt is the only mandatory option The target s portal lt target_portal gt and port lt port gt information are optional and if they are not provided a default target portal is used If you do not specify the remaining options these options are set to their default values When you set the authentication method lt Auth gt to a value other than 0 you must set additional parameters to specify the initiator CHAP name target CHAP name and initiator and target secret strings Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser If you set the authentication m
48. driver s necessary to run the adapter If you change personalities you must install the appropriate drivers Drivers are available on the Emulex website ChangePersonality Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd ChangePersonality lt WWPN MAC gt lt personality_type gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command changes the personality on the adapter Requires reboot after successful change Parameters WWPN CNA s WWPN MAC MAC address of iSCSI or NIC Port Personality Type NIC iSCSI or FCoE Example For non ESXi hosts gt hbacmd ChangePersonality 00 12 34 56 78 9A fco For ESXi hosts gt hbacmd h lt IP_Adress gt m cim u root p lt password gt n lt namespace gt ChangePersonality 00 12 34 56 78 9A fco OneCommand Manager Command Line Interface User Manual Page 77 gt G EMULEX ShowPersonalities Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd ShowPersonalities lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command displays the list of personalities available on the adap
49. e following are already present on the system the install script attempts to remove them first e HBAnyware utility e OneCommand Manager core kit e OneCommand Manager application enterprise kit e Solaris driver utilities OneCommand Manager Command Line Interface User Manual Page 5 gt G EMULEX Starting and Stopping Linux and Solaris Daemon Processes On Linux and Solaris machines you can stop and start the OneCommand Manager daemon processes using the stop_ocmanager and start_ocmanager scripts respectively These are found in the following OneCommand Manager installation directory Linux usr sbin ocmanager Solaris opt ELXocm There are three basic daemon processes included with OneCommand Manager installations that are affected by these scripts They are e elxhbamgrd Remote management daemon which services requests from OneCommand Manager clients running on remote host machines e mili2d MILI daemon that routes major portions of the local OneCommand Manager client CNA management requests e elxdiscoveryd Discovery daemon responsible for maintaining all discovery data remote and local for OneCommand Manager clients running on the local machine elxhbamgrd and mili2d start at system boot time elxdiscoveryd starts whenever the OneCommand Manager GUI process first runs on the host machine Additionally if the web launch component of OneCommand Manager is installed the daemon process rmiserver starts at syste
50. ength in meters Note When Mode 0 the Speed and Length arguements are ignored When Mode 1 the Length arguement is ignored Example The following example configures the port to a forced speed of 1 Gb sec with a cable length of 2 meters hbacmd setphyportspeed 00 00 c9 ad ad ac 2 1Gb 2 Authentication Commands Note Authentication commands are supported on FC adapter ports only AuthConfigList Supported by Windows Solaris and Linux Syntax hbacmd AuthConfigList lt WWPN gt Description This command returns the list of WWPNs that have an authentication connection configuration with the specified adapter Parameters WWPN Adapter s WWPN DeleteAuthConfig Supported by Windows Solaris and Linux Syntax hbacmd DeleteAuthConfig lt WWPN1 gt lt WWPN2 gt lt PasswordType gt lt Password gt Description This command deletes the authentication configuration on the adapter Parameters WWPN1 Adapter s WWPN WWPN2 Must be ff ff ff ff ff ff ff ff for a switch or the actual WWPN for a target PasswordType 1 ASCII 2 Hex binary 3 Password not yet defined Password Current password value OneCommand Manager Command Line Interface User Manual Page 24 gt G EMULEX GetAuthConfig Supported by Windows Solaris and Linux Syntax hbacmd GetAuthConfig lt WWPN1 gt lt WWPN2 gt Description This command retrieves the authentication configuration for the adapter Parameters
51. er Manual Page 30 gt G EMULEX SetCnaPGBW Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetCnaPGBW lt WWPN MAC gt lt BWO BW7 gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command sets the bandwidth percentage of a priority group according to the following rules 1 Bandwidths BWO to BW7 must add up to 100 2 Bandwidth can be assigned to a priority group that has priorities Parameters WWPN Adapter s WWPN MAC MAC address of the NIC or iSCSI port BW Bandwidth allocated for each priority group Example This command sets the bandwidth of PGIDO to 50 PGID1 to 50 and the rest to 0 hbacmd SetCnaPGBW 10 00 00 00 c9 3c f 7 88 5050000000 SetDCBParam Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetDCBParam lt WWPN MAC gt lt Param gt lt Value gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command configures the DCB and LLDP settings on the OneConnect adapter Parameters WWPN Adapter s WWPN MAC MAC address of the NIC or iSCSI port OneConnect adapter parameters 1 enabled 0 disabled Note The One
52. escseseshseseseeenexenesh 2 Drocedures 2 In a VMware ESX Server with an Existing HBAnyware or OneCommand Manager CL 2 IC EUR Hehe eege 3 e TEE 3 Proc dures 5 shah EE EEReg 3 In Linux with an Existing OneCommand Manager CLI Kit ceeeeeeteeeeeees 4 Ne IEN 4 Drocedures tt ttttttnnE EEEE EEEESSEEEEEEEEEESEEEEEEEEEESS EEEE E EEEE 4 Upgradihigassr aa aA 4 Performing a Clean Install cccccccceeeeeeeeeeeeeeeeceeeeeeeeeeeeetaaeeeeeeeeeeeeenaaees 5 lee 5 ee IEN 5 elei EE 5 Starting and Stopping Linux and Solaris Daemon Processes sssssssssssseeeeeen 6 Uninstalling the OneCommand Manager CL 6 MD VU UO OWS ee E EE ce cee eee eee eects 6 In aVMware ESX SIV Cl ees eelere e 6 Uninstalling Older HBAnyware or OneCommand Manager Kits in a KEE H ep Ba Ub EE EE 7 Uninstalling Older HBAnyware Kits in Linus 7 lge Ee 8 Upgrading the OneCommand Manager CLI to the OneCommand Manager Application Enterprise kt 8 In Wmdows ccc eeeeeeeeeeeeeeeaaaeeeeeeeeeeeeeaaaaeeeeeeeeeeesaaaeaeeeeeeeseesaaaaeeeeeseeeesaaa 9 In a VMware ESX S rvel ceeccccseseeeteeeeteeee tena aa eeeeeeeeeaaaaaee 9 In Lmus OE 9 In Solaris serrrrrirrrriririiriririrnii kinikini niak K NANNA NN ANANKA KANN NK KA KNKN NNKAN KANN KANN KANN KAN KAKARA KK KAKANAN 9 Using the OneCommand Manager Command Line Interface 10 Managing Devices Using CIM cccccecceeccnceeeeeeeeeeecccaeeeeeeeeeetenccaeeeeeeeeneeee 10 The CLI Client Command Reference
53. ethod to One Way CHAP value of 1 you must also specify the Target CHAP Name and Target Secret Example hbacmd TargetLogin 00 11 22 33 44 55 iscsitarget Auth 1 TgtChapName TargetSecretl If the you set the authentication method to Mutual CHAP value of 2 you must specify all 4 values Example hbacmd TargetLogin 00 11 22 33 44 55 iscsitarget Auth 2 TgtChapName TargetSecret1 InitCHAPName InitialSecret1 OneCommand Manager Command Line Interface User Manual Page 63 gt G EMULEX Parameters MAC_Address MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 Port Port number of the target portal value 1024 65535 ImmediateData 0 No 1 Yes default 1 HeaderDigest 0 None 1 CRC32C default 0 DataDigest 0 None 1 CRC32C default 0 Auth 0 None 1 One Way CHAP 2 Mutual CHAP default 0 TgtCHAPName Target CHAP name enclosed in quotes string length 1 255 TgtSecret Target Secret enclosed in quotes string length 12 16 InitCHAPName Initiator CHAP name enclosed in quotes string length 1 255 InitSecret Initiator Secret enclosed in quotes string length 12 16 Note If you set Auth to 1 you must specify the TgtCHAPName and TgtSecret If you set Auth to 2 you must specify the TgtCHAPName TgtSecret InitCHAPName and InitSecret TargetLogout Supported by Windows Solaris Linux and VMware ESX Syntax hbac
54. fault CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows PCI configuration data The PCI registers displayed are specific to the function referenced in the OneCommand Manager CLI For example if you specify the WWPN for the FCoE function the PCI registers for that FCoE function return If you specify the MAC address for the NIC function on that same physical port the PCI registers for that NIC function return Only the base PCI registers return The extended PCI registers are not available on a CNA Parameters WWPN Adapter s WWPN port MAC MAC address of the NIC or iSCSI port Type 1 Formatted SFS data 2 Raw SFS data The OneCommand Manager CLI has a command that displays wakeup parameter information much the same way that the OneCommand Manager application displays it in its own control field Example C Program Files emulex Util OCManager gt hbacmd h 10 192 203 154 m cim u root p Swamiji001 n root emulex pcidata 00 00 c9 93 2f d6 OneCommand Manager Command Line Interface User Manual Page 37 gt E EMULEX Output Vendor ID Ox19A2 Device ID 0x0700 Command 0x0406 Status 0x0010 Revision ID 0x02 Prog If 0x00 Subclass 0x00 Base Class 0x02 Cache Line Size 0x10 Latency Timer 0x00 Header Type 0x80 Built In Self Test 0x00 Base Address 0 0x00000000 Base Address 1 OxDF478000 Base Address 2 OxDF480004 Base Address 3 0
55. from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows if volatile change is supported for the WWPN Parameters WWPN Adapter s WWPN ReadWWN Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd ReadWWN lt WWPN gt lt Type gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command reads different types of WWNs OneCommand Manager Command Line Interface User Manual Page 81 gt G EMULEX Parameters WWPN Adapter s WWPN Type 0 Volatile 1 Non Volatile 2 Factory Default 3 Current 4 Configured RestoreWWN Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd RestoreWWN lt WWPN gt lt Type gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command changes the WWNs to the factory default or non volatile values Change is non volatile Note A reboot is required to activate the new setting Note For VMware ESX After changing the WWN of an adapter you must reboot the ESX
56. g space separators the entire WWPN must be enclosed in quotes e When a MAC address is specified the fields are separated by a dash e Fields using angle brackets lt gt are required e Fields using square brackets are optional Syntax Rules for CIM The syntax of the existing HbaCmd commands are the same except for the additional m cim option for getting the data from the ESXi host Following is a list of HoaCmd commands supported through the CIM interface e AddHost e AllNodelnfo e CEEDownload e ChangePersonality e ChangeWWN e ClearAllAadapterLicenses e DeleteDumpFiles e Download e Dump e EnableBootCode e GetBeacon e GetDCBParams e GetDriverParams e GetDriverParamsGlobal e GetDumpDirectory e GetDumpFile e GetDumpFileNames e GetFcflInfo e GetFipParams e GetLunList e GetPGInfo OneCommand Manager Command Line Interface User Manual Page 14 gt E EMULEX e GetQoslnfo e GetRetentionCount e GetVPD e GetWWNCap e GetXcvrData e HbaAttributes e InstallAdapterLicense e ListHbas e LoadList e Test e PciData e PortAttributes e PortStatistics e ReadWWN e RemoveHost e Reset e RestoreWWN e ServerAttributes e SetBeacon e SetCableNVP e SetCnaPGBW e SetDCBParam e SetDCBPriority e SetDriverParam e SetDriverParamDefaults e SetDumpDirectory e SetFIPParam e SetRetentionCount e ShowAdapterLicenseFeatures e ShowLicenseAdapterlD e ShowPersonalities e TargetMap
57. get_name gt Description This command shows all the LUNs and their information for a specified target The iSCSI target name lt iscsi_target_name gt tells the command to gather the information from the specified iSCSI target Parameters MAC_Address MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 OneCommand Manager Command Line Interface User Manual Page 54 gt G EMULEX GetiSCSIPortStats Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port GetiSCSIPortStats lt MAC_Address gt Description This command shows all the port statistics for a specified port Parameters MAC_Address MAC address of the CNA port GetSessionInfo Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port GetSessionInfo lt MAC_Address gt lt iscsi_target_name gt lt TSIH lt ISID_Qual Target_IP gt gt Description This command lists all session information for a specified session You must specify the iSCSI target name lt iscsi_target_name gt and either the TSIH lt TSI gt of the session or the session s ISID Qualifier lt ISTD_Qua1 gt and the target s IP address lt Target_IP gt These parameters tell the command to gather the information from the specified target and session You can find the TSIH and ISID qualifier by running the ListSessions command Parameters MAC_A
58. ing length 0 32 Immediate Data 0 No 1 Yes default 1 HeaderDigest 0 None 1 CRC32C default 0 DataDigest 0 None 1 CRC32C default 0 OneCommand Manager Command Line Interface User Manual Page 57 gt G EMULEX Auth 0 None 1 One Way CHAP 2 Mutual CHAP default 0 TgtCHAPName Target CHAP name enclosed in quotes string length 1 256 TgtSecret Target Secret enclosed in quotes string length 12 16 InitCHAPName Initiator CHAP name enclosed in quotes string length 1 256 InitSecret Initiator Secret enclosed in quotes string length 12 16 Note If you set Auth to 1 you must also specify the TgtCHAPName and TgtSecret If you set Auth is set to a value of 2 you must also specify the TgtCHAPName TgtSecret InitCHAPName and InitSecret SetNetworkConfiguration Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port SetNetworkConfiguration lt MAC_Address gt lt VLAN_ENABLED lt 0 1 gt lt VLAN_ID lt 0 4096 gt gt lt Priority lt 0 7 gt gt lt DHCP lt 0 1 gt gt lt IP_Address gt lt Subnet_Mask gt Gateway Description This command sets the TCP IP configuration on a specified port The required fields for this command depend upon the values set for DHCP lt DHcP gt and VLAN Enabled lt VLAN_ENABLED gt Parameters MAC_Address MAC address of the CNA port VLAN_ENABLED 0 Disabled 1 Enabled
59. ion gt Or rpm e elxocmcor sxNN lt kit version gt NN is 40 for an ESX 4 0 system 41 for an ESX 4 1 system and 50 for an ESXi 5 0 system In Linux To uninstall the OneCommand Manager CLI on Linux 1 Log in as root 2 Run the uninstall script uninstall_ocmanager sh located in usr sbin nbanyware scripts Or Run the uninstall script uninstall sh located in the installation tar file Uninstalling Older HBAnyware Kits in Linux Uninstalling an older HBAnyware core kit 1 Run the following command to remove the core kit rpm e elxlinuxcorekit Uninstalling an older HBAnyware enterprise kit 1 Run the uninstall script located in usr sbin nbanyware scripts to remove the enterprise kit Or Run the uninstall script located in the tar file to remove the enterprise kit If the HBAnyware Security Configurator is installed you must uninstall it before uninstalling the HBAnyware configuration utility You must use the uninstall script that shipped with the version of OneCommand Security Configurator you want to remove and proceed to step 2 If the Security Configurator is not installed proceed to step 3 OneCommand Manager Command Line Interface User Manual Page 7 gt G EMULEX 2 Ifthe HBAnyware Security Configurator is installed follow these steps a Log on as root Change to the directory containing the tar file Extract the tar file using the tar xvf command Change to the newly created directory Ru
60. ired for the TDR test for the cable that connects to the phyical port associated with the WWPN or MAC Parameters WWPN WWPN of the FC port MAC MAC address of the NIC or iSCSI port NVP A percentage value between 1 and 100 Consult your cable documentation to obtain the proper NVP value Wakeup Note Not supported for OneConnect adapters Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd Wakeup lt WWPN gt Description This command wakes up the adapter Parameters WWPN Adapter s WWPN OneCommand Manager Command Line Interface User Manual Page 39 gt G EMULEX Driver Parameter Commands Note Supported for FC and FCoE ports only Note Driver parameters that are set temporarily and globally using the G and T flags must be read using the GetDriverParams hbacmd command to view the current value of the parameter The GetDriverParamsGlobal hbacmd command returns only permanently set driver parameter values Additionally if temporary global values have been set for one or more driver parameters the SaveConfig hbacmd command must be run with the N flag using the N flag is analogous to the hbacmd command GetDriverParams to force the driver parameter values for the specified adapter to be saved Inaccurate values may be saved if the G flag is used for this command Note The DriverConfig and SetDriverParamDefaults commands are not supported for Solaris
61. is command to make any changes to the target portal s login properties When you set the authentication method lt Auth gt to a value other than 0 you must set additional parameters to specify the initiator CHAP name target CHAP name and initiator and target secret strings Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser These properties are used when discovering the targets on the target portal The targets inherit the target portal s properties when they are discovered Targets already discovered do not inherit the updated properties only newly discovered targets inherit the properties OneCommand Manager Command Line Interface User Manual Page 60 gt G EMULEX Example hbacmd SetTPLoginProperties 00 11 22 33 44 55 10 192 1 1 5050 Auth 1 TgtChapName TargetSecret1 If you set the authentication method to Mutual CHAP value of 2 you must specify all 4 values Example hbacmd SetTPLoginProperties 00 11 22 33 44 55 10 192 1 1 5050 Auth 2 TgtChapName TargetSecret1 InitCHAPName InitialSecret1 Parameters MAC_Address MAC address of the CNA port Target_IP IP address of the target portal Port Port number of the target portal value 1024 65535 ImmediateData 0 No 1 Yes default 1 HeaderDigest 0 None 1 CRC32C default 0 DataDigest 0 None 1 CRC32C default 0 Auth 0 None 1 One Way CHAP 2 Mutual CHAP default
62. is is how hbacmd identifies the adapter It does not imply that the command works on the specified port Note Adapter License Management Commands are supported on OneConnect adapters only InstallAdapterLicense Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd InstallAdapterLicense lt WWPN MAC gt lt LicenseFile gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command installs the license keys from a license file to enable specific features on the adapter Parameters License File The path to the license key file containing the license keys obtained from the License website WWPN Adapter s FCoE port WWPN MAC Adapter s NIC or iSCSI port address OneCommand Manager Command Line Interface User Manual Page 19 gt G EMULEX Example For non ESXi hosts hbacmd InstallAdapterLicense 00 12 34 56 78 9A K 1f 1324 lic For ESXi hosts hbacmd h lt IP_Address gt m cim u root p lt password gt n lt namespace gt InstallAdapterLicense 00 12 34 56 78 9A K 1 1324 lic ShowAdapterLicenseFeatures Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd ShowAdapterLicenseFeatures lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The
63. it is activated with this switch The q switch displays some progress reports The q2 switch does not display progress reports For example elxocmcore windows x64 5 01 00 10 4 exe q2 In a New VMware ESX Server To install the OneCommand Manager CLI in a new VMware system install the specific rpm file for the driver for your VMware version For ESXi servers including 5 0 see page 10 for CIM provider installation instructions Prerequisites e To manage FCoE adapters the LPFC driver version 8 2 or later must be loaded e To manage NIC or iSCSI adapters driver version 2 102 440 0 or later must be loaded e To manage iSCSI adapters the iSCSI driver must be loaded Note The iSCSI driver is not supported for VMware ESX 4 0 Procedures To install the OneCommand Manager CLI Log in to the ESX server COS 2 Copy the elxocmcore esxNN lt kit version gt lt arch gt rpm file to a directory on the install machine 3 CD to the directory where you copied the rpm file Install the rpm file by typing rpm Uvh elxocmcor sxNN lt kit version gt lt arch gt rpm NN is 40 for an ESX 4 0 system 41 for an ESX 4 1 system and 50 for an ESXi 5 0 system The rpm contents are installed in usr sbin ocmanager The OneCommand Manager CLI is also located in this directory In a VMware ESX Server with an Existing HBAnyware or OneCommand Manager CLI To install the OneCommand Manager CLI in a VMware system with an existing H
64. king commands are not supported by Linux Note The GetLunMaskbyHBA GetLunMaskbyTarget RescanLuns and SetLunMask commands are not supported for VMware ESX and Solaris GetLunList Supported by Windows and Solaris Syntax hbacmd GetLunList lt HBA WWPN gt lt Target WWPN gt lt Option gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command queries for the presence of any masked LUNs Parameters HBA WWPN Adapter s WWPN Target WWPN World wide port name of the target Option 0 Get information from driver 1 Get information from configuration OneCommand Manager Command Line Interface User Manual Page 65 gt G EMULEX GetLunUnMaskByHBA Supported by Windows and Solaris Syntax hbacmd GetLunUnMaskByHBA lt HBA WWPN gt lt Option gt Description This command queries for the presence of any unmasked LUNs by adapter Parameters HBA WWPN Adapter s WWPN Option 0 Get information from driver 1 Get information from configuration GetLunUnMaskByTarget Supported by Windows and Solaris Syntax hbacmd GetLunUnMaskByTarget lt HBA WWPN gt lt Target WWPN gt lt Option gt Description This command queries for any unmasked LUNs by target Parameters HBA WWPN Adapter s WWPN Target WWPN Target s WWPN Option
65. le entry from the specified port Parameters MAC_ Address MAC address of the CNA port Dest_IP_Address Destination IP address to delete from the route table Subnet_Mask Subnet Mask to delete from the route table Gateway Gateway to delete from the route table OneCommand Manager Command Line Interface User Manual Page 53 gt G EMULEX DiscoveriSNSServer Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port DiscoveriSNSServer lt MAC_Address gt Description This command discovers an iSNS server address through DHCP If the DHCP server returns an ISNS server address it replaces the configured iSNS server and can be viewed using the ShowiSNSServer command Parameters MAC_Address MAC address of the CNA port GetinitiatorProperties Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port GetInitiatorProperties lt MAC_Address gt Description This command shows all the initiator login options for the specified port Parameters MAC_Address MAC address of the CNA port Note These properties are set as the target portal s login properties to be used when discovering the targets on the target portal The discovered targets inherit these properties GetiSCSILuns Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port GetiSCSILuns lt MAC_Address gt lt iscsi_tar
66. le shows the dump directory set to vmfs volumes ocm datastore GetDumpFile Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h ipAddress GetDumpFile lt WWPN MAC gt lt filename gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command gets the dump file For dump file retrieval over FC FCoE the WWPN of a remote FC FCoE port is required to access the remote host This command gets the user specified dump file to local client s dump directory The dump directory local and remote is named Dump and is placed under the OCManager installation directory Since the dump files are copied from the Dump directory of the remote host to the Dump directory of the local host specifying a local port identifier for this command returns the following error since the source and destination directory is the same ERROR HBACMD_GetDumpFile RM_GetDumpFile call failed 2 ERROR lt 2 gt Not Supported OneCommand Manager Command Line Interface User Manual Page 45 gt G EMULEX Dump directory For Windows C Program Files Emulex Util Dump For Linux usr sbin ocmanager Dump For Solaris opt ELXocm Dump For ESX The dump directory set using the SetDumpDirectory command Parameters WWPN Adapter s WWPN MAC MAC address of the CNA port l
67. leNames GetFCFlInfo GetFipParams GetRetentionCount GetPGInfo SetDCBParam SetCnaPgBw SetDCBPriority SetDumpDirectory SetFIPParam SetRetentionCount Commands Supported in CIM Provider 3 2 Note In addition to the commands supported by the CIM Provider 3 0 and 3 1 the following commands are supported by the CIM Provider 3 2 ChangePersonality InstallAdapterLicense ShowAdapterLicenseFeatures ShowLicenseAdapter D ShowPersonalities Commands Supported in CIM Provider 3 4 4 Note In addition to the commands supported by the CIM Provider 3 0 3 1 and 3 2 the following command is supported by the CIM Provider 3 4 4 SetCableNVP Commands Supported in CIM Provider 3 5 Note In addition to the commands supported by the CIM Provider 3 0 3 1 3 2 and 3 4 4 the following command is supported by the CIM Provider 3 5 SetPhyPortSpeed OneCommand Manager Command Line Interface User Manual Page 17 gt G EMULEX Commands Supported in Target mode Ports Note The following HoaCmd commands are supported for managing target mode ports DeleteDumpFiles Download DriverConfig ExportSanInfo GetDCBParams GetDriverParams GetDriverParamsGlobal GetDumpDirectory GetFCFInfo GetFIPParams GetPGInfo GetPortStatistics GetRetentionCount GetVPD GetXcvrData HbaAttributes ListHBAs PortAttributes Reset SaveConfig ServerAttributes SetDCBPGBW SetDCBParam SetDriverParam SetDriverParamDefaults SetFIPParam SetPor
68. lt Auth gt to a value other than 0 you must set additional parameters to specify the initiator CHAP name target CHAP name and initiator and target secret strings Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser Example hbacmd SetTargetLoginProperties 00 11 22 33 44 55 iscsitarget Auth 1 TgtCHAPName TargetSecretl If you set the authentication method to Mutual CHAP value of 2 you must also specify all 4 values Example hbacmd SetTargetLoginProperties 00 11 22 33 44 55 iscsitarget Auth 2 TgtChapName TargetSecret1 InitCHAPName InitialSecret1 Parameters MAC_Address MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 Immediate Data 0 No 1 Yes default 1 HeaderDigest 0 None 1 CRC32C default 0 DataDigest 0 None 1 CRC32C default 0 Auth 0 None 1 One Way CHAP 2 Mutual CHAP default 0 TgtCHAPName Target CHAP name enclosed in quotes string length 1 255 OneCommand Manager Command Line Interface User Manual Page 59 gt G EMULEX TgtSecret Target Secret enclosed in quotes string length 12 16 InitCHAPName Initiator CHAP name enclosed in quotes string length 1 255 InitSecret Initiator Secret enclosed in quotes string length 12 16 Note If you set Auth is set to 1 you must specify the TgtCHAPName and TgtSecret If
69. m boot time The start_weblaunch and stop_weblaunch scripts start and stop this daemon Uninstalling the OneCommand Manager CLI In Windows To uninstall the OneCommand Manager CLI in Windows 1 In Windows 2003 Select Start gt Control Panel gt Add Remove Programs or In Windows 2008 and Windows 2008 R2 Select Start gt Control Panel gt Programs gt Uninstall a Program 2 If present select Emulex Common SAN Management version and click Remove or Uninstall Click Yes The Emulex Common SAN Management components are removed from the system 3 Select Emulex OCManager CLI version and click Remove or Uninstall In a VMware ESX Server To uninstall the OneCommand Manager CLI in a VMware server Log into the ESX server COS 2 Type rpm e elxocmcore esxNN lt version gt Where NN is 40 for an ESX 4 0 system 41 for an ESX 4 1 system and 50 for an ESXi 5 0 sys tem OneCommand Manager Command Line Interface User Manual Page 6 gt G EMULEX Uninstalling Older HBAnyware or OneCommand Manager Kits in a VMware ESX Server To uninstall an older OneCommand Manager or HBAnyware Kit on a VMware server Log into the ESX server COS 2 Type rpm qa grep elx and locate either of the following rpm files elxvmwarecorekit lt kit version gt Or elxocmcore esxNN lt kit version gt NN is 40 for an ESX 4 0 system 41 for an ESX 4 1 system and 50 for an ESXi 5 0 system 3 Type rpm e elxvmwarecorekit lt kit vers
70. md h host_IP port hostname port TargetLogout lt MAC_Address gt lt iscsi_target_name gt lt TSIH lt ISID_Qual Target_IP gt Description This command logs out of a target The required fields are the iSCSI target name lt iscsi_target_name gt and either the TSIH lt 7S H gt of the session or the session s ISID qualifier lt S ID_Qual gt and the target s IP address lt Target_IP gt Parameters MAC_Address The MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 TSIH TSIH value of the session to log out values 1 65535 ISID_Qual ISID qualifier of the session to logout value 0 65535 Target_IP The Target s IP address OneCommand Manager Command Line Interface User Manual Page 64 gt G EMULEX UpdateiSNSServer Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port UpdateiSNSServer lt MAC_Address gt lt Server_IP gt lt Port gt Description This command updates the configured iSNS server This command requires the server IP lt Server_ P gt and port number lt Port gt of the iSNS server be available to respond to the iSNS requests Parameters MAC_Address MAC address of the CNA port Server_IP IP address of the iSNS server to configure Port Port number of the iSNS server to configure value 1024 65535 LUN Masking Commands Note Supported for FC FCoE ports only Note LUN mas
71. n COMMANAS cccccccseccceceeeeeeceeceeeececeeeeeeecuceeeeaeeeeeeaeeeeeeeeaaes 24 AuthbtCGonfol jet 24 Deletehutht ong 24 GetAUthContig ccccececeeeeeeeececneeeeeeeeeeeeeecaaeeeeeeeeeeeeceaaeeeeeeeeeseeesneeeeeess 25 EE LEE TE 25 InitiateAuth 20 0 ccc ecceeeeccceeeeeeeeeeseeeaneeeanestaneseaueeeaneeeaaeetaeetaeetaeetaeesaneeeanes 25 SLAW TING OM MIG ME 25 MEL RASSW OMe EE 26 Boot COMMANAS ccccscssssesscscscesesccseusesausesauseceuseueuseusesausesaueasausecausauansaeuseneas 27 EnableBootCoqde sssssssssriuesrrirssrrrusrrrrirerrrsrrrrisnrrrusnrrrsrrrrennrnennrrnuren nrnna 27 GetBootParaMS isinara napaan aaa aasa A aaa RE EAEEREN 27 SetBootP arafa a a A A EEA 28 CEE Commande 28 GEES 28 Ge EE Param S eainnt erada aa aaa aidd 29 SEIGEE Raa M EE EE 29 Data Center Bridging Commandes 30 GetDCBParas 1 00 cccccccceeccecceeecceeeeeceeceeseeeeeueueeecaeeceesaeeeeeeaueeeeeeaeeeeeeaaes 30 GOP SIMO srna nanasgainenauashaneavasienasiandesenieeedadnaniaal 30 EE UE 31 Se tDCBParam ccccccccseeccecceeeeceeceeeceeceeseceeeeeeeeecaeeeeeeeeueeeeaueeeeeaeeeeeeaaes 31 SetDCBPriority cccccccceeeeeeeeecceeeeeeeeeeeeeecaaeeeeeeeeeseceaaeeeeeeeeeseensaaeeeeeees 33 Bt ietuie Enter elgu E 34 ECHO TEE 34 GetBeacon ssssssssssssssriiesrriresrrrrsrrtrtsrr trenn rrr e errr earr EEnA EEEE AEEESE EEES A EEEn n EEE nnn rne 34 GetXCvr Data WEEE 35 Be Le 35 LOOPBACK EE 36 ME QOPIV EE 36 UE 37 POSTS Tg cecabsachevav
72. n the uninstall script with the ssc parameter specified Type uninstall ssc 9205 3 Uninstall the HBAnyware utility and the Application Helper module a Log on as root b Change to the directory containing the tar file c Extract the tar file using the tar xvf command d Change to the newly created directory e Uninstall any previously installed versions Type uninstall In Solaris To uninstall the OneCommand Manager CLI on Solaris 1 Log in as root 1 Run opt ELXocm scripts uninstall Or Run the uninstall script located in the installation tar file Or Enter the command pkgrm ELXocmcore Upgrading the OneCommand Manager CLI to the OneCommand Manager Application Enterprise Kit Note An upgrade can be performed only if the version of the OneCommand Manager application enterprise kit is the same or later than the OneCommand Manager CLI version You cannot upgrade a OneCommand Manager CLI with a previous version of the OneCommand Manager application enterprise kit Note When the OneCommand Vision Sensor software is installed on production servers with Emulex adapters installed the Sensor software may load and use some of the software components included in the OneCommand Manager application or HBAnyware utility software stacks It is essential that the OneCommand Vision Sensor software be stopped before performing any upgrades or updates to the OneCommand Manager application or HBAnyware
73. nagement in the OneCommand Manager GUI The adapters for these hosts are also presented by the listhbas command The host_address can be an IP address using the IPv4 or IPv6 format or a host name Parameters host_address Host to add OneCommand Manager Command Line Interface User Manual Page 67 gt G EMULEX CnaClearEventLog Note Supported for OneConnect adapters only Supported by Windows Linux and VMware ESX Syntax hbacmd CnaClearEventLog lt WWPN MAC gt Description This command clears the CNA eventlog specified by the WWPN or MAC address Parameters WWPN WWPN of the CNA FCoE port MAC MAC address of NIC or iSCSI port of the CNA CnaGetEventLog Note Supported for OneConnect adapters only Supported by Windows Linux and VMware ESX Syntax hbacmd CnaGetEventLog lt WWPN MAC gt Description This command shows the CNA event log specified by the WWPN or MAC address Parameters WWPN Adapter s WWPN port MAC MAC address of the NIC or iSCSI port Download Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd Download lt WWPN MAC gt lt FileName gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Note For 16 Gb HBA firmware downloads OneCommand Manager only accepts grp files Description L
74. oads the firmware image to the FC or CNA port specified by the WWPN or MAC address Parameters WWPN Port s WWPN MAC The MAC address of the NIC or iSCSI port FileName The name and location of the firmware image any file accessible to the CLI client OneCommand Manager Command Line Interface User Manual Page 68 gt G EMULEX Note For OneConnect and 16 Gb HBA adapters while the WWPN or MAC address is used to identify the adapter the updated firmware applies to all ports on that adapter It is not necessary to download the firmware on all the adapter ports of a OneConnect adapter or a 16 Gb HBA adapter ExportSANIinfo Note Emulex recommends that you redirect this output to a file with proper extension xml for XML formatted files and csv for CSV formatted files Note Due to the amount of information that must be obtained and reported this command can take a long time on large SAN configurations Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd ExportSANInfo format Note format is optional If the format parameter is specified as csv adapter information is shown in csv format If the format parameter is specified as xml adapter information is shown in xml format Leaving the format parameter blank shows the data in xml format Description For reporting purposes this command captures the SAN information in xml or csv format As large amount of information is outp
75. olaris Linux and VMware ESX Syntax hbacmd PortStatistics lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows all port statistics for the adapter The type of information listed may vary according to the adapter model Parameters WWPN Adapter s WWPN ServerAttributes Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd ServerAttributes lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows a list of server attributes for the adapter The type of information listed may vary according to the adapter model Parameters WWPN Adapter s WWPN MAC MAC address of the NIC or iSCSI port SetPfcThrottle Note The PFC Throttle state returns when using the PortAttributes command for OneConnect adapters However for OneConnect adapters with older firmware that does not support PfcThrottle and for non OneConnect adapters the PFC Throttle state does not return when using the PortAttributes command Supported by Windows and Linux Syntax hbacmd SetPfcThrottle lt WWPN gt lt 0 1 gt Description This command returns
76. ommand shows transceiver data such as vendor name and serial number Parameters WWPN Adapter s WWPN port MAC MAC address of the NIC or iSCSI port Example C Program Files emulex Util OCManager gt hbacmd h 10 192 203 154 m cim u root p Swamiji001 n root emulex getxcvrdata 00 00 c9 93 2f d6 LoadList Note Not supported for OneConnect adapters Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd LoadList lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the flash memory load list data for the adapter Parameters WWPN Adapter s WWPN OneCommand Manager Command Line Interface User Manual Page 35 gt G EMULEX LoopBackTest Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd LoopBackTest lt WWPN MAC gt lt Type gt lt Count gt lt StopOnError gt Pattern Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command runs the loop test on the adapter specified by the WWPN or MAC address Only PHY loopback test and MAC loopback tests are enabled for OneConnect adapters Note Loopback tests can be run on F
77. p password n root emulex setdumpdirectory lt DumpDirectoryName gt ESX using the RM remote management interface hbacmd h ipaddress port setdumpdirectory lt DumpDirectoryName gt Description This command sets the dump directory for the ESX ESXi host The Dump feature works only if the Dump directory is set for the ESX ESXi host To use the SetDumpDirectory command you must have a directory mapped under vmfs volumes where the files will be dumped This directory points to the internal hard disk or an external storage area and can also be mapped using the vSphere Client utility from VMware OneCommand Manager Command Line Interface User Manual Page 44 gt G EMULEX Note For VMware systems you must set a dump directory before initiating a dump The dump directory must be a Storage partition a datastore under the directory vmfs volumes The application checks for the Dump directory and creates the dump files in that location Note The dump directory applies to all adapters in the server There is no separate dump directory for each adapter Parameters lt DumpDirectoryName gt The directory under vmfs volumes that you created to store the dump files h Host s IP address m cim u root p lt password gt n lt namespace gt Example hbacmd h 10 192 203 173 m cim u root p Swamiji001 n root emulex setdumpdirectory 10 00 00 00 c9 61 f2 64 ocm datastore This examp
78. pecific port Parameters MAC Address MAC address of the CNA port Example hbacmd h 10 192 203 240 showroutetableentry 00 00 c9 a0 ce 77 ShowTarget Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port ShowTarget lt MAC_Address gt lt iscsi_target_name gt refreshtargets Description This command shows the properties for a specified target If you do not specify the iSCSI target name lt iscsi_target_name gt all targets and their associated properties return If you specify refreshtargets in place of the iSCSI target name all targets are refreshed before returning the information If you provide no iSCSI Target name and do not specify refreshtargets only the targets from the last refresh are displayed Parameters MAC_Address MAC address of the CNA port iscsi_target_name Target s iSCSI name enclosed in quotes string length 11 255 refreshtargets Refresh all targets before displaying the information Note Only one command option can be specified with this command If you provide the lt iscsi_target_name gt you cannot specify refreshtargets Likewise if you specify refreshtargets then you cannot specify the lt iscsi_target_name gt OneCommand Manager Command Line Interface User Manual Page 62 gt G EMULEX ShowTargetPortal Supported by Windows Solaris and Linux Syntax hbacmd h host_IP port hostname port ShowTargetPortal lt MAC_Ad
79. ping OneCommand Manager Command Line Interface User Manual Page 15 gt G EMULEX The Command Reference CLI Client commands are supported for Windows Solaris Linux and VMware ESX Commands Not Supported in Linux and Solaris Note The following commands are not supported in Linux and Solaris PersistentBinding SetPersistentBinding RemovePersistentBinding RemoveAllPersistentBinding BindingCapabilities BindingSupport SetBindingSupport SetPfcThrottle SetPfcThrottle is supported in Linux but not in Solaris Commands Not Supported in VMware ESX Note The following commands are not supported in VMware ESX BindingCapabilities BindingSupport CreateVPort DeleteVPort GetLunMaskByHBA GetLunMaskByTarget PersistentBinding RescanLuns RemoveAllPersistentBinding RemovePersistentBinding SetBindingSupport SetLunMask SetPersistentBinding Commands Supported in CIM Interface Commands Supported in CIM Provider 3 0 Note The following commands are supported by the CIM Provider 3 0 for UCNA Download ChangeWWN GetWWNCap GetXcvrData LoadList Loopbacktest GetBeacon SetBeacon ReadWWN Reset RestorewWWN OneCommand Manager Command Line Interface User Manual Page 16 Commands Supported in CIM Provider 3 1 gt G EMULEX Note In addition to the commands supported by the CIM Provider 3 0 the following commands are supported by the CIM Provider 3 1 Dump GetDCBParams GetDumpDierctory GetDumpFile GetDumpFi
80. re Kits in Linux on page 7 Performing a Clean Install Follow these steps 1 Uninstall the existing OneCommand Manager CLI using the uninstall script included in the tar file or in ust sbin ocmanager scripts directory Note If an HBAnyware CLI or enterprise kit is installed follow the procedure for Uninstalling Older HBAnyware Kits in Linux on page 7 Note Your configuration files are backed up by rpm with an rpmsave extension 2 Install the specific rpm file for your driver for Linux version For information on installing the rpm file see installing the OneCommand Manager CLI In Linux on page 3 In Solaris Prerequisites e The Solaris FC FCoE driver version 2 60 or later must be installed for FC FCoE management e The Solaris OCE NIC driver version 1 0 or later must be installed for UNCA management Note If Emulex OneConnect UNCAs are installed on the system the NIC driver must be installed and reporting all NIC ports Otherwise OneCommand Manager cannot manage the UNCAs Procedures To install the OneCommand Manager CLI Copy the OneCommand Manager core kit to a temporary directory on the system 2 Untar the core kit by typing tar xvf elxocmcore solaris lt kit version gt tar 3 Change to the newly created elxocmcore solaris lt kit version gt directory cd elxocmcore solaris lt kit version gt 4 Run the install script and follow the instructions install If any of th
81. ress hbacmd SetTargetProperties 00 11 22 33 44 55 iscsiTarget 1 The command sets the extended timeout value to 1 The OneCommand Manager CLI 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 Managing Devices Using CIM VMware on the Visor based ESX platforms uses the Common Interface Model CIM as the only standard management mechanism for device management OneCommand Manager uses the standard CIM interfaces to manage the adapters in the ESX COS and Visor environments and supports CIM based device and HBA management OneCommand Manager also supports existing HBA management functionality based on its proprietary management stack and the standard HBAAPI interface To manage the adapters on an ESX ESXi host using OneCommand Manager you must install the Emulex CIM Provider on the host ESX ESXi 3 5 4 0 and 4 1 come with an inbox Emulex CIM Provider The inbox Emulex CIM Provider enables you to manage Emulex LightPulse adapters but not Emulex UCNA adapters To manage Emulex UCNA adapters you must install the out of box Emulex CIM Provider The Emulex CIM Provider is available as a core kit rom in the ESX COS platform and as an offline bundle in ESXi platforms VMWare recommends using the offline bundle to upgrade software on VMWare platforms For more information about the ESX Patch Management activities refer to the VMware website Yo
82. ription This command shows the boot parameters If any arguments are missing or invalid a suitable error is reported If all arguments are correct the data is displayed in tabular form Parameters WWPN Adapter s WWPN Type X86 UEFI OB OneCommand Manager Command Line Interface User Manual Page 27 gt G EMULEX SetBootParam Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetBootParam lt WWPN gt lt Type gt lt Param gt lt Valuel gt BootDev lt Value2 gt Description This command changes the boot parameters You can change adapter parameters and boot device parameters for OpenBoot x86 and UEFI boot e When changing adapter parameters omit the BootDev keyword and value otherwise an error is reported e When changing bootdevice parameters for OpenBoot omit the BootDev keyword and value otherwise an error is reported e For boot device parameters for X86 or UEFI you must provide the BootDev keyword and value Parameters WWPN Adapter s WWPN Type X86 UEFI OB Param Parameter name Value1 Parameter value BootDev The boot device Value2 Boot device entry number 0 7 CEE Commands Note Converged Enhanced Ethernet CEE commands are for CEE management of LP21000 series adapters only CEEDownload Note Supported for LP21000 series adapters only Not supported for OneConnect adapters Supported by Windows Solaris Linux and VMware ESX Syntax
83. rtual ports name optional Virtual WWPN The virtual WWPN to create Virtual WWNN The virtual WWNN to create DeleteVPort Supported by Windows Solaris and Linux Syntax hbacmd DeleteVPort lt physical WWPN gt lt virtual WWPN gt Description This command deletes the virtual port specified by a physical and virtual WWPN Parameters Physical WWPN Adapter s WWPN Virtual WWPN The WWPN of the virtual port ListVMs Note This command lists information for VMware ESX only Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd ListVMs lt physical WWPN gt lt virtual WWPN gt Description This command lists all virtual machines and their information for all manageable ports If you specify the host with the h lt host gt option or just give the physical WWPN only the virtual machines for that host return If you specify the physical port and the virtual port only the virtual machine for the specified virtual port returns The virtual machine name is only displayed if the virtual port is associated with a virtual machine on VMware ESX 4 0 4 1 or ESXi 5 0 If you are running this command on any other server that has virtual ports you will not see the virtual machine name Parameters Physical WWPN Adapter s WWPN Virtual WWPN The WWPN of the virtual port OneCommand Manager Command Line Interface User Manual Page 79 gt G EMULEX ListVPorts Supported by Windows Solaris Linux
84. s 49 eeler alla EE 50 Aere Er EE 50 ee Ee td ln E 51 CleariSNSServet ccecccccceeeeecccceeeeeeeeeeeeeecceeeeeeeeeeeecccaaeeeeeeeeeeeeedaaeeeeeeeennee 53 DelARP Table Entry ns 53 DelRouteTableEntry EN 53 DiscoveriSNSServer EE 54 GetlnitiatorProperties ccceeeeeeeeeeeeeeeeneee eee eeeeeeeecaaeeeeeeeeeeeeedaaeeeeeeeeeeeed 54 EE ET E 54 GetiSCSIPortStats cccceeeceeeee cece eeeeeee ee eee eter eeteecaaaeeeeeeeeseeeedaaaeeeeeneeenee 55 GetSessionlnfo cece eeeeceeeee cette ee eeceee ee eee eee eeeeeeaaaeeeeeeeeeeeeeaaaeeeeeneeeaeee 55 tS OS mila o ee ee 55 Ree EE 56 REMOS Ta EE 56 Rule Va re el LE 56 SetlnitiatorPropertieS cccceeeeeeeeeeeeeeceeeeeeeeeeeeeeeaaeeeeeeeeeeeeeciaeeeeeeeeetee 57 SetNetworkConfiguration c ccccccccceeceeeeeeeeeeeceeeeaaeeeeeeeeeeeeectaeeeeeessenaaaes 58 Get Targett oginbropertles nnn 59 SetTargetPropertieS 0 cceccceeceeee eee eeeeeeneeee eee eeeeeceaaaeeeeeeeeteeecaaaeeeeeeeteneea 60 SetTPLOginProperties ccccccceeeeeeeeeeeceeeeeeeeeeeeccaaeeeeeeeeeeeeenaaeeeeeeeeeteed 60 SNOWARP ET 61 ShowiSNSServer eee 62 Ghowbtoute Table 62 Ghow large eee 62 ShowTargetPortal cccccccceceeeeeeeeeeeeeeeeccneeeeeeeeeeecccaeeeeeeeeeeeeedeeeeeeeeeenee 63 BET le e WEE 63 Elte Beie e 64 UpdateichGGerver nnne 65 LUN Masking Commandes ssssssseessseieeeessssriresssrstrtrrnnntsssttrnnnnnnssntnnnnnnnnnennnnn 65 Gei unt jet 65 Gei un lnMask BvHpDA aaa aaia 6
85. s from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 For LightPulse adapters only hbacmd h ipaddress port m cim u username p password n root emulex Dump lt WWPN MAC gt Description This command creates a diagnostic dump file in the hbacmd dump file directory OneCommand Manager Command Line Interface User Manual Page 43 gt G EMULEX Parameters WWPN Adapter s WWPN MAC MAC address of the CNA port h Host s IP address m cim u root p lt password gt n lt namespace gt GetDumpDirectory Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h ipaddress port m cim u username p password n root emulex GetDumpDirectory lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the dump file directory for the adapters in the host Note The dump directory applies to all adapters in the server There is nota separate dump directory for each adapter Parameters WWPN Adapter s WWPN MAC MAC address of the CNA port SetDumpDirectory Supported by VMware ESX ESXi Syntax ESX ESXI using the CIM interace hbacmd h ipaddress port m cim u username
86. s target node information for each target accessible by the adapter Parameters WWPN Adapter s WWPN BindingCapabilities Supported by Windows and Solaris Syntax hbacmd BindingCapabilities lt WWPN gt Description This command shows the binding capabilities of the adapter If a binding is configured it is maintained across reboots Parameters WWPN Adapter s WWPN BindingSupport Supported by Windows and Solaris Syntax hbacmd BindingSupport lt WWPN gt lt Source gt Description This command shows the binding support for the adapter Parameters WWPN Adapter s WWPN Source C Configuration support L Live support PersistentBinding Supported by Windows and Solaris Syntax hbacmd PersistentBinding lt WWPN gt lt Source gt Description This command specifies which set of persistent binding information configured or live state is requested OneCommand Manager Command Line Interface User Manual Page 74 Parameters WWPN Adapter s WWPN Source C Configuration L Live RemoveAllPersistentBinding Supported by Windows and Solaris Syntax hbacmd RemoveAllPersistentBinding lt WWPN gt Description Removes all persisting bindings for the adapter Parameters WWPN Adapter s WWPN RemovePersistentBinding Supported by Windows and Solaris Syntax gt G EMULEX hbacmd RemovePersistentBinding lt WWPN gt lt BindType gt lt ID gt lt SCSIBus gt lt SCSITarget gt
87. scription This command adds an Address Resolution Protocol table entry Parameters MAC_Address MAC address of the CNA port Dest_MAC_Address Destination MAC address to add to the ARP table Dest_IP_Address Destination IP address to add to the ARP table OneCommand Manager Command Line Interface User Manual Page 49 gt G EMULEX AddRouteTableEntry Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port AddRouteTableEntry lt MAC_Address gt lt Dest_IP_Address gt lt Subnet_Mask gt lt Gateway gt Description This command adds a new route table entry to the route table of the specified port Parameters MAC_Address MAC address of the CNA port Dest_IP_Address Destination IP address to add to the route table Subnet_Mask Subnet Mask to add to the route table Gateway Gateway to add to the route table AddTarget Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port AddTarget lt MAC_Address gt lt Target_IP gt lt Port gt lt iscsi_target_name gt ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 0 1 gt Auth lt 0 1 2 gt TgtCHAPName TgtSecret InitCHAPName TnitSecret Description This command adds a target to the list of targets seen by the initiator and logs into the target once it has been successfully created This command requires that you specify a valid target IP
88. software stack components For information on stopping the Sensor refer the OneCommand Vision user manual OneCommand Manager Command Line Interface User Manual Page 8 gt G EMULEX In Windows To upgrade from the OneCommand Manager CLI to the full featured OneCommand Manager application enterprise kit 1 From the desktop run the elxocm windows lt kit version gt exe file that contains the full application kit Running this executable file removes the OneCommand Manager CLI and installs a full featured version of the OneCommand Manager application that includes the CLI and the GUI In a VMware ESX Server The full featured OneCommand Manager application enterprise kit is not supported for VMware ESX In Linux To upgrade from the OneCommand Manager CLI to the full featured OneCommand Manager application enterprise kit 1 Run the install sh script of the OneCommand Manager application enterprise kit The install script executes an rom upgrade rpm U rpm to upgrade the installed core kit to an enterprise kit In Solaris To upgrade from the OneCommand Manager CLI to the full featured OneCommand Manager application enterprise kit 1 Download the OneCommand Manager application enterprise kit to a temporary directory on your system 2 Untar the OneCommand Manager application enterprise kit tar file tar xvf elxocm solaris lt kit version gt tar 3 Change to the newly created elxocm lt kit version gt director
89. specify an initiator name lt Initiator_Name gt and an initiator alias lt Initiator_Alias gt If you opt not to specify these fields a default iSCSI name is assigned When you set authentication method lt Auth gt to a value other than 0 you must set additional parameters to specify the initiator target CHAP name and secret strings Enclose these strings in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser Except for the Initiator_Name and Initiator_Alias properties these properties are set as the target portal s login properties to be used when discovering the targets on the target portal The targets inherit the target portal s properties when they are discovered The discovered target s login properties can be changed using the SetTargetProperties command Additionally these properties are used for iSNS target discovery to set the discovered target s login properties Example hbacmd SetInitiatorProperties 00 11 22 33 44 55 Auth 1 TgtChapName TargetSecretl If you specify the authentication method to Mutual CHAP value of 2 you must specify all 4 values Example hbacmd SetInitiatorProperties 00 11 22 33 44 55 Auth 2 TgtChapName TargetSecret1 InitCHAPName InitialSecret1 Parameters MAC_Address MAC address of the CNA port Initiator_Name Initiator iSCSI name enclosed in quotes string length 1 224 Initiator_Alias Initiator iSCSI alias enclosed in quotes str
90. t filename gt Name of the dump file to be copied from the remote hostExample hbacmd h 10 192 193 154 m cim u root p Swamiji001 n root emulex getdumpfile BG HBANYWARE 15_10000000c97d1314_20100120 032820421 dmp GetDumpFileNames Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetDumpFileNames lt WWPN MAC gt Or hbacmd lt h ipAddress gt GetDumpFileNames Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command gets the names of the files in the remote host s dump directory Parameters WWPN Adapter s WWPN MAC MAC address of the CNA port h Host s IP address Example hbacmd h 10 192 193 154 m cim u root p Swamiji001 n root emulex getdumpfilenames GetRetentionCount Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetRetentionCount lt WWPN MAC gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the maximum number of diagnostic dump files to keep OneCommand Manager Command Line Interface User Manual Page 46 gt G EMULEX Parameters WWPN Adapter s WWPN MAC MAC address of the CNA port SetReten
91. tEnabled SetRetentionCount All other HbaCmd commands return the error message Not Supported for Target Mode Adapters Parameters Not Supported in the CIM Interface The following parameters are not supported ESX 3i U4 via CIM Provider v 2 0 9 x e HbaAttributes e Opt ROM Version Operational FW e ServerAttributes s FW Resource Path s DP Resource Path Read Only Mode The OneCommand Manager CLI does not allow the execution of certain commands when it is configured for read only mode An error message returns 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 OneCommand Manager Command Line Interface User Manual Page 18 gt G EMULEX Help Command The HbaCmd help command lists help for the HoaCmd console application Help Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd Help GroupName CmdName Description Help is displayed at three levels The command hbacmd help lists by groups all the commands The command hbacmd groupname lists all the commands in the group The command help commandname shows the help for the specific command Parameters GroupName All commands in the group CmdName Any CLI command Adapter License Management Commands Note In these commands the WWPN or MAC address argument is given only one is used to specify the adapter the command is acting upon Th
92. ter The personality type is displayed as either NIC iSCSI or FCoE Parameters WWPRN CNA s WWPN MAC MAC address of iSCSI or NIC port Example For non ESxXi hosts gt hbacmd ShowPersonalities 00 12 34 56 78 9A For ESXi hosts gt hbacmd h lt IP_Address gt m cim u root p lt password gt n lt namespace gt showpersonalities 00 12 34 56 78 9A Virtual Port VPort Commands Note Supported by FC and FCoE adapter ports only lt gt Required Optional CreateVPort Supported by Windows Solaris 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 This command creates a virtual port with an automatically generated WWPN or a user specified virtual WWPN on the specified physical port If you specify auto the virtual WWPN is 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 Note In Linux VPorts do not persist across system reboots OneCommand Manager Command Line Interface User Manual Page 78 gt G EMULEX Parameters Physical WWPN WWPN of the object adapter Auto The virtual WWPN is automatically generated for the virtual port Vname The vi
93. these options are set to their default values When you set the authentication method lt Auth gt to a value other than 0 you must set additional parameters to specify the initiator CHAP name target CHAP name and initiator and target secret strings Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser If you set the authentication method to One Way CHAP value of 1 you must also set the Target CHAP Name and Target Secret Example hbacmd AddTargetPortal 00 11 22 33 44 55 10 0 0 1 8000 Auth 1 TgtCHAPName TargetSecretl If you set the authentication method to Mutual CHAP value of 2 You must specify all 4 values Example hbacmd AddTargetPortal 00 11 22 33 44 55 10 0 0 1 8000 Auth 2 TgtChapName TargetSecret1 InitCHAPName InitialSecret1 Parameters MAC Address MAC address of the CNA port Target_IP IP address of the target portal Port Port number of the target portal value 1024 65535 ImmediateData 0 No 1 Yes default 1 HeaderDigest 0 None 1 CRC32C default 0 DataDigest 0 None 1 CRC32C default 0 Auth 0 None 1 One Way CHAP 2 Mutual CHAP default 0 TgtCHAPName Target CHAP name enclosed in quotes string length 1 256 TgtSecret Target Secret enclosed in quotes string length 12 16 InitCHAPName Initiator CHAP name enclosed in quotes string length 1 256 InitSecret Initiator Secret en
94. tionCount Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetRetentionCount lt WWPN MAC gt lt Value gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command specifies the maximum number of diagnostic dump files for the adapter When the count reaches the limit the next dump operation deletes the oldest file Note The retention count applies to all adapters in the server Parameters WWPN Adapter s WWPN MAC MAC address of the CNA port Value The number of dump files to retain Example hbacmd h 10 192 193 154 m cim u root p Swamiji001 n root emulex SetRetentionCount 00 00 c9 93 2f 9f 6 FCoE Commands Note These commands are supported only on OneConnect FCoE ports GetFCFinfo Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetFCFInfo lt WWPN gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the FCF information of the OneConnect adapter in FCoE mode Parameters WWPN Adapter s WWPN Example hbacmd getfcfinfo 10 00 00 00 c9 3c f7 88 OneCommand Manager Command Line Interface User Manual
95. tly both LLDP Rx and Tx must be enabled If either Rx or Tx is disabled DCBX is disabled TxPortDesc Transmit Port Description Provides a description of the port in an alpha numeric format The value equals the ifDescr object if the LAN device supports RFC 2863 TxSysDesc Transmit System Description Provides a description of the network entity in an alpha numeric format This includes the system s name and versions of hardware oper ating system and networking software supported by the device The value equals the sysDe scr object if the LAN device supports RFC 3418 TxSysName Transmit System Name Provides the system s assigned name in an alpha numeric format The value equals the sysName object if the LAN device supports RFC 3418 TxSysCap Transmit System Capabililities Indicates the primary function s of the device and whether or not these functions are enabled on the device The capabilities are indicated by two octets Bits 0 through 7 indicate Other Repeater Bridge WLAN AP Router Tele phone DOCSIS cable device and Station respectively Bits 8 through 15 are reserved Where multiple values are possible specify them with a comma separated list Example hbacmd h 10 192 203 151 m cim u root p Swamiji001 n root emulex setdcbparam 00 00 c9 3c f 7 88 fcoepriority 3 OneCommand Manager Command Line Interface User Manual Page 32 gt G EMULEX SetDCBPriority Supported by Windows Solaris Lin
96. u can use the following syntax for issuing CIM based commands A gt hbacmd lt h IPAddress port gt m cim u userid p password n root emulex command lt WWPN gt B gt hbacmd lt h IPAddress port gt lt m cim gt lt cmd gt OneCommand Manager Command Line Interface User Manual Page 10 Before issuing the syntax B do one of the following e Add the host IP with CIM credentials using the AddHost command For example hbacmd lt m cim gt AddHost lt IPAddress gt u userid p password Or e Set the default CIM credentials using the SetCimCred command n namespace Note This command sets only the CIM credentials Once you have set these subsequent HbaCmd commands do not require you specify the CIM credentials on the command line For example hbacmd SetCimCred lt username gt lt password gt lt namespace gt lt portnum gt Note If you specify the command with the discovery method m cim and you do not specify the CIM credentials userid password or namespace the default value for the missing CIM credential is obtained in the following order 1 The information entered using the addhost command is looked up 2 If no values exist the information entered using the setcimcred command is used 3 If no values exist the following credentials are used username root password root namespace root emulex portnum 5988 Note The OneCommand Manager CLI running on VMware ES
97. ust be ff ff ff ff ff ff ff ff for a switch or the actual WWPN for a target PasswordType 1 ASCII 2 Hex binary 3 Password not yet defined Password Current password value Parameter 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 Solaris 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 This command sets the password for the adapter Parameters WWPN1 Adapter s WWPN WWPN2 Must be ff ff ff ff ff ff ff ff for switch or the actual WWPN for target 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 1 ASCII 2 Hex binary 3 Password not yet defined Cpw Current password value OneCommand Manager Command Line Interface User Manual Page 26 gt G EMULEX Npt New password type 1 ASCII 2
98. ut from this command Emulex recommends that you re direct the output to a file Parameters Format csv Output information in CSV format xml Output information in XML format default GetCimCred Supported by Windows Syntax hbacmd GetCimCred Description This command shows the default credentials set for the CIM client Note The password is encrypted Parameters None OneCommand Manager Command Line Interface User Manual Page 69 gt G EMULEX GetElxSeclinfo Supported by Windows and Linux Syntax hbacmd GetElxSecInfo Description This command shows the version of the ElxSec system Parameters None GetQoSlinfo Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd h host_IP port hostname port GetQoSInfo lt MAC_Address gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command shows the QoS information for a specified NIC port Parameters h Host s IP address or hostname WWPN Adapter s WWPN port MAC MAC address of the NIC or iSCSI port Example C Program Files emulex Util OCManager gt hbacmd h 10 192 203 154 m cim u root p Swamiji001 n root emulex getqosinfo 00 00 c9 93 2f d6 GetVPD Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd GetVPD lt WWPN MAC gt
99. ux and VMware ESX Syntax hbacmd SetDCBPriority lt WWPN MAC gt lt PFC Priorities gt lt Priorities of PGID0 gt lt Priorities of PGID1 gt lt Priorities of PGID7 gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command sets the priorities for a priority group The values must be set according to the following rules The priorities range from 0 to 7 The Priority group IDs PGID range from 0 to 7 A priority can exist in only one priority group All priorities must appear once in any of the eight PGO PG7 priority groups Each set of priorities for a group must be separated by a space Specify multiple priorities for the same group by a comma separated list To specify none use for the argument The same priority values cannot be specified to different groups All priorities 0 to 7 must be assigned to some PGID 0 Not all PGIDs must be assigned a priority 1 Se el eer Se Not all adapters support two PFC priorities and eight priority groups For Adapters if you exceed the PFC priorities or priority groups an error message appears FCoE Adapter Specific Rules 1 Minimum of one and a maximum of two PFC priorities can be configured 2 One of the PFC priorities must match FCoE priority 3 The additional PFC priority must be assigned to
100. x00000000 Base Address 4 OxDF4A0004 Base Address 5 0x00000000 Crs 0x00000000 SubVendor ID 0x10DF SubSystem ID OxE622 ROM Base Address 0x00000000 Interrupt Line 0x00 Interrupt Pin 0x01 Minimum Grant 0x00 Maximum Latency 0x00 Capabilities Ptr 0x40 PostTest Note Not supported for OneConnect adapters Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd PostTest lt WWPN gt Description This command runs the POST on the adapter Support for a remote adapter is via TCP IP access only Parameters WWPN Adapter s WWPN SetBeacon Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetBeacon lt WWPN MAC gt lt BeaconState gt Note For managing ESX ESXi hosts from a Windows client add the m cim option to the command The default CIM credentials must be set using the SetCimCred command See SetCimCred on page 72 Description This command turns the beacon ON or OFF Parameters WWPN WWPN of the FC port MAC MAC address of the NIC or iSCSI port OneCommand Manager Command Line Interface User Manual Page 38 gt G EMULEX BeaconState New state of the beacon 0 Off 1 On SetCableNVP Note This command supports only OneConnect OCe11100 series adapters Supported by Windows Solaris Linux and VMware ESX Syntax hbacmd SetCableNVP lt WWPN MAC gt lt NVP gt Description This command sets the nominal velocity of propagation N V P requ
101. y cd elxocm solaris lt kit version gt 4 Run the install script and follow the instructions install OneCommand Manager Command Line Interface User Manual Page 9 gt G EMULEX Using the OneCommand Manager Command Line Interface The Command Line Interface CLI Client component of the OneCommand Manager application provides access to the capabilities 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 storage area network SAN and show that information on the console Most of the CLI Client commands require one or more additional parameters that specify the nature of the command For FC ports the world wide port name WWPN of the adapter must be specified For example run the following command to display the port attributes for the adapter with the specified WWPN hbacmd PortAttributes 10 00 00 00 c9 20 20 20 For iSCSI and NIC ports the MAC address must be specified For example run the following command to set the target properties for the CNA port with the specified MAC add
102. y notice Emulex assumes no responsibility for its use nor for any infringements 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 website www opensolaris org or by contacting online support from the website 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 OneCommand Manager Command Line Interface User Manual Page ii Introductio TEE 1 Compatibility ccc ennenen eee eee eeccaaeee eset eeteceaaaeeeeeeeeeeeccaaaaeeeeeeeenececaeeeeeees 1 New Features in this Helease 1 NOW EE HE HE 1 Installing the OneCommand Manager CL 1 rd Tele VE 1 Attended Installation in WiINGOWS 0 cccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeaaaeeeteneeeeeees 1 Unattended Installation in Windows AAA 2 In a New VMware ESX Gerver eeeeeessnsersrnrersrrsssr trr r rnnr rnnr nananana nena 2 Proregul Sio S iiss secenecetecenenecexexexexesexasenesexexenesesasenenesestseneses

User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents