Home

User Manual

image

Contents

1. in n 28 pr Ww Dr 28 hi M C 29 4 CLI Client Command Usage s piss k skon QUA A JTERNUA VA DULCE RU EVA xd bas b EN R AA 30 OVer VIG ucc DOO CERO R ODER ROCA o E ikon 30 HbaCmd Syntax Usage sccccccccccccccsscnsccccccccccscccececscsecssscsecceceececcesssceses 30 Secure Management CLI Interface 52 ro sure eonun rana an aE o paa da sd nA ER k UE 32 Device Management Using the Secure Management Interface sss 32 Syntax Rules for the Secure Management Interface esee eene 32 CIM A Qu Peer tonov 32 Device Management Using the CIM Interface sssseeeeeeeeeee eene eene 33 Syntax Rules tor the CIM Interface ssssessessossssecsssscsosesocesesscossecoseseeess 33 Syntax Options and Setting CIM Credentials ussssssssesessessessssssesesessesssssseses 33 Example of Using the CIM Interface to Display Adapters esee 34 CLI Client Commands Supported in CIM Interface sssssssesssessssseesssesesssesee 35 CIM Provider 3 Oi os trits ttipia ava Cerar dana V ENE EVEEDEE TAAA 37 CIM PIOVider 3 MP Em 37 CIM Provider 3 2 M 38 CIM Providetr 3 4 4 onak voda bv osa bavi N N EE ENEE EE 38 CIM Prov
2. InitiateAuth WWPN1 WWPN2 Parameters WWPN1 The WWPN of the adapter WWPN2 Use ff ff ff ff ff ff ff ff for a switch or use the WWPN for a target SetAuthConfig This command sets the authentication configuration for the adapter Supported By Linux Solaris and Windows Syntax SetAuthConfig WWPN1 lt WWPN2 gt PasswordType Password Param Value Note Where multiple parameters and values are used separate them using commas Parameters WWPN1 The WWPN of the adapter WWPN2 Use ff ff ff ff ff ff ff ff for a switch or use the WWPN for a target PasswordType 1 ASCII 2 Hex binary 3 Password not yet defined Password The current password value OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 59 Authentication Commands Param The parameter names Mode Timeout Bi directional Hash priority DH priority Re authentication Re authentication interval Value The value is based on the type of lt Param gt SetPassword Mode disabled enabled or passive Timeout time in seconds Bi directional disabled or enabled Hash priority md5 or shal md5 first md5 then sha1 shal first shal then md DH priority 1 2 3 4 5 any combination up to 5 digits Re authentication disabled or enabled Re authentication interval 0 10 3600 This command sets the password for the adapte
3. 2 EMULEX iSCSI Commands DelARPTableEntry This command removes an ARP table entry Supported By Linux Solaris VMware ESX and Windows Syntax DelARPTableEntry MAC Address lt Dest MAC Address Dest IP Address Parameters MAC Address The MAC address of the UCNA port Dest MAC Address The destination MAC address to remove from the ARP table Dest IP Address The destination IP address to remove from the ARP table DelRouteTableEntry This command removes a route table entry from the specified port Supported By Linux Solaris VMware ESX and Windows Syntax DelRouteTableEntry MAC Address Dest IP Address Subnet Mask Gateway Parameters MAC Address MAC address of the UCNA 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 DiscoveriSNSServer 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 Supported By Linux Solaris VMware ESX and Windows Syntax DiscoveriSNSServer MAC Address OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 9 1 2c EMULEX iSCSI Commands Parameters MAC Address The MAC address of the UCNA port Export
4. GetAuthStatus Y Y Y 57 GetBootParams Y Y Y Y 61 GetCimCred Y 109 GetDCBParams Y Y Y Y Y viv Y Y 65 GetDriverParams Y Y 4 Y Y 77 GetDriverParamsGlobal Y Y Y Y Y 77 GetDumpDirectory Y Y 4 Y Y 80 GetDumpFile Y Y Y Y Y 81 GetDumpFileNames Y Y Y Y Y 82 GetElxSecInfo Y Y 110 GetFCFInfo Y Y Y Y 84 GetFIPParams Y Y Y Y 84 GetlnitiatorProperties v Y Y Y 91 GetiSCSILuns Y Y Y Y 91 GetiSCSIPortStats Y Y 4 Y 92 GetLunList Y Y Y Y 105 GetLunUnMaskByHBA Y Y 105 GetLunUnMaskByTarget Y Y 106 GetNetwork Y Y Y Y 92 Configuration GetPGInfo Y Y Y Y v v Y Y 66 GetOoslnfo v Y Y Y 110 GetRetentionCount Y Y Y Y Viv Y v 8 GetSessionInfo Y Y Y Y 92 GetVPD Y Y Y Y Y 110 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX Table 5 1 CLI Client Command Reference Continued 5 CLI Client Command Descriptions CIM Provider VMWare Command Linux Solaris ESX Windows CIM 3 0 3 1 3 2 3 4 4 3 5 Page GetWWNCap Y Y Y Y Y 129 GetXcvrData Y Y 71 HbaAttributes Y Y Y Y 53 Help Y v v Y 48 ImportiSCSI Y Y Y 93 InitiateAuth Y Y Y 58 InstallAdapterLicense Y Y Y Y Y Y Y Y 51 iSCSIPing Y Y Y Y 94 ListHBAs Y Y Y Y Y 111 ListSessions Y Y Y Y 94 ListVFunctions Y Y Y Y 126 ListVMs Y Y 126 ListVPorts Y Y Y Y 127 VPortTargets Y Y Y Y 127 LoadList Y Y Y Y viv Viv Y
5. 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 the VMware documentation Supported By Linux Solaris VMware ESX and Windows Syntax Change WWN WWPN New WWPN New WWNN gt Type OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 129 WWN Management Commands Parameters WWPN The WWPN of the adapter New WWPN The WWPN of the new adapter New WWNN The WWNN of the new adapter Type 0 Volatile 1 Non Volatile GetWWNCap This command shows if volatile change is supported for the WWPN Supported By Linux Solaris VMware ESX and Windows Syntax GetWWNCap lt WWPN gt Parameters WWPN The WWPN of the adapter ReadWWN This command reads different types of WWNs Supported By Linux Solaris VMware ESX and Windows Syntax ReadWWN WWPN Type Parameters WWPN The WWPN of the adapter Type 0 Volatile 1 Non Volatile 2 Factory Default 3 Current 4 Configured RestoreWWN This command changes the WWNs to the factory default or non volatile values The change is non volatile OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is S CLI Client Command
6. Supported By Linux Solaris VMware ESX and Windows Syntax iSCSIPing lt MAC Address gt lt IP Address gt Parameters MAC Address The MAC address of the UCNA port IP Address IP address of target to send ICMP echo reguest ListSessions This command lists all the sessions on a specified target The command gathers the information from the iSCSI target indicated by the lt iscsi_target_name gt parameter Supported By Linux Solaris VMware ESX and Windows Syntax ListSessions MAC Address lt iscsi target name Parameters MAC Address The MAC address of the UCNA port iscsi target name Target s iSCSI name enclosed in quotes The string length is 11 255 Remove Target This command removes the target with the specified iSCSI target name lt iscsi_target_name gt Supported By Linux Solaris VMware ESX and Windows Syntax RemoveTarget MAC Address lt iscsi target name OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 95 2c EMULEX iSCSI Commands Parameters MAC Address The MAC address of the UCNA port iscsi target name Target s iSCSI name enclosed in quotes The string length is 11 255 RemoveTargetPortal This command removes the SendTarget Portal containing the target IP Target IP and the port Port from the list of portals for the specified initiator Supported By Linux Solaris VMware ESX and Windows Syntax Remov
7. This command sets the TCP IP configuration on a specified port The required fields for this command depend upon the values set for lt DHCP gt and lt VLAN_ENABLED gt Supported By Linux Solaris VMware ESX and Windows Syntax SetNetworkConfiguration MAC Address lt VLAN ENABLED lt 0 1 gt lt VLAN ID 0 4096 lt Priority lt 0 7 gt gt lt DHCP lt 0 1 gt gt lt IP Address Subnet Mask Gateway Parameters MAC Address The MAC address of the UCNA port OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 98 2c EMULEX iSCSI Commands VLAN ENABLED 0 Disabled 1 Enabled VLAN_ID VLAN ID of the interface The possible values are 0 4095 Priority VLAN priority of the interface The possible values are 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 IP_Address and Subnet_Mask are required only if DHCP is disabled otherwise these values should be omitted SetTargetLoginProperties 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
8. download the appropriate driver from the Emulex website and install the driver For example e On OneConnect FCoE adapters o For RHEL 5 5and later and SLES10 SP3 and later operating systems use Linux driver version 8 2 0 x o For RHEL6 and later and SL11 SP1 and later operating systems use Linux driver version 8 3 5 x e On OneConnect iSCSI adapters use the iSCSI driver OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 18 DE EMULEX 2 Installing and Uninstalling the CLI 19 Linux e On OneConnect NIC adapters including iSCSI NIC and FCoE NIC adapters use the Ethernet driver Note The OneCommand Manager core kit cannot be installed if a previous version of the HBAnyware utility is installed You have two options when installing the OneCommand Manager CLI on a Linux system with an existing OneCommand CLI kit e Updating an existing installation preserve existing settings e Performing a clean install overwrite existing settings Updating Preserving Existing Settings To update the OneCommand Manager CLI and preserve settings you must install the current core kit as detailed in Installing in Linux Without an Existing OneCommand CLI Kit on page 17 The rpm file handles the configuration file update The install script executes an rpm update rpm U rpm to update the installed version of the core kit to the current version Note There is no update path from an HBAnywar
9. you do not need to be present during the installation Installation will complete on its own Installation progress may be displayed as an option Attended Installation 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 Use the following syntax for the installation executable file elxocmcore windows lt arch gt lt kit version gt exe e arch is either x64 or x86 e kit version represents the complete kit version For example at the command prompt type elxocmcore windows x64 5 0 2 14 1 exe Note For Itanium 64 systems install the x86 kit Unattended Installation To install the OneCommand Manager CLI in Windows unattended use the following procedure 1 From the Emulex website download the x64 or x86 OneCommand Manager Core Kit installation file to your system OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 2 Installing and Uninstalling the CLI 25 Windows 2 Use the following syntax for the installation executable file elxocmcore windows lt arch gt lt kit version gt exe lt option gt 3 Activate the kit with switch g or g2 e The q switch displays progress reports e The q2 switch does not display progress reports 4 Youcan enable Secure Management Mode by adding the sec 1 argument or disable it by sec 0 If the s
10. 6 3 User Manual P009403 01A Rev A 1 Introduction 16 DG EMULEX OneCommand Manager Secure Management Linux and Solaris Interactive Installation Enterprise OCM installations done in interactive mode will ask if OCM Secure Management mode should be enabled If the answer is yes the other management mode questions will be skipped If the answer is no to the OCM Secure Management mode question then the management mode installation questions will follow Unattended Installation with Install Script Switch Option Support Enterprise OCM installations done in unattended mode provides a switch option to enable OCM Secure Management If the OCM Secure Management switch is not used with the installation Secure Management will be disabled Windows During OCM installations done in interactive mode you will be presented with a management mode window where you can select Secure Management as the management mode Using OneCommand Manager with Secure Management Enabled To run the HBACMD application when Secure Management is enabled you must include your user name and password each time you type a command For example Secure Management disabled hbacmd lt command gt Secure Management enabled hbacmd lt m sec gt lt userid gt lt password gt lt command gt User names and passwords are used to authenticate the commands Once the credentials are authenticated the OCM will determine which one of the four user groups you belong to and w
11. CLI s UMC commands allow viewing of the UMC configuration enabling and disabling of the UMC at the adapter level and the modification of some of the channel properties The UMC commands cannot be used to manage other channel management types see Channel Management Commands on page 62 for more information Notes e The UMC command UmcSetChanLink is no longer available Its functionality can be done by the UmcSetBw command e Properties for all channels on a port can be viewed and modified with the UMC commands even when UMC is disabled This allows enabling and configuration of UMC on all channels and rebooting and running UMC without further configuration e For IBM adapters UMC mode may be referred to as vNIC2 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 121 2c EMULEX UMC Commands e The UMC commands are not available on OCe11101 EM EX or OCe11102 EM EX adapters The following error will be returned ERROR 251 Hardware or firmware does not support command UmcEnable This command enables or disables UMC at the adapter level A system reboot is required to make the change take effect Notes e TheUmcEnable command will enable UMC channel management only but it will disable any channel management type in effect when it is used e The CMMode command can also be used to enable UMC or other channel management modes Su
12. Client Command Reference CIM Provider VMWare Command Linux Solaris ESX Windows CIM 3 0 3 1 3 2 3 4 4 3 5 Page AddARPTableEntry 86 AddHost Y Y Y Y 107 AddRouteTableEntry Y Y Y Y 86 AddTarget Y Y Y Y 87 AddTargetPortal Y Y Y Y 88 AllNodelnfo Y Y Y Y Y 115 AuthConfigList Y Y Y 56 BindingCapabilities Y Y 115 BindingSupport Y Y 116 ChangePersonality Y Y Y Y 119 ChangeWWN Y Y Y Y viv 128 CleariSNSServer Y Y Y Y 89 CMGetParams Y Y Y Y 62 CMMode Y Y Y Y 63 CMSetBW Y Y Y Y 64 CnaClearEventLog Y Y Y 107 CnaGetEventLog Y Y Y 108 CreateVPort Y Y Y 125 DelARPTableEntry Y Y Y Y 90 DeleteAuthConfig Y Y Y 57 DelRouteTableEntry Y Y Y 90 DeleteDumpFiles Y Y Y Y 79 DeleteVPort Y Y Y 125 DiscoveriSNSServer Y Y Y Y 90 Download Y Y Y Y vl ov Y Y 108 DriverConfig Y Y Y 77 Dump Y Y Y Y 4 Y Y Y Y 180 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX Table 5 1 CLI Client Command Reference Continued 5 CLI Client Command Descriptions 44 CIM Provider VMWare Command Linux Solaris ESX Windows CIM 3 0 3 1 3 2 3 4 4 3 5 Page EchoTest Y Y Y Y 70 EnableBootCode Y 60 ExportSANInfo Y Y Y Y 109 ExportiSCSI Y Y Y Y 91 GetBeacon Y Y Y Y vl lv Y Y 70 GetAuthConfig Y Y Y 57
13. EMULEX CIM Interface e ChangePersonality e ChangeWWN e CMGetParams e CMMode e CMSetBW e DeleteDumpFiles e Download e Dump e EnableBootCode e GetBeacon e GetDCBParams e GetDriverParams e GetDriverParamsGlobal e GetDumpbDirectory e GetDumplile e GetDumpFileNames e GetFCFInfo e GetFIPParams e GetLunList e GetPGInfo e GetQosInfo e GetRetentionCount e GetVPD e GetWWNCap e GetXcvrData e HbaAttributes e InstallAdapterLicense e ListHBAs e LoadList e LoopBackTest e PciData e PortAttributes e PortStatistics e ReadWWN e RemoveHost e Reset e RestoreWWN e ServerAttributes e SetBeacon OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX SetCnaPGBW SetDCBParam SetDCBPriority SetDriverParam SetDriverParamDefaults SetDumpDirectory SetFIPParam SetPFCthrottle SetPhyPortSpeed SetRetentionCount Show AdapterLicenseFeatures ShowLicenseAdapterID ShowPersonalities UmcEnable UmcGetParams UmcSetBw UmcSet LPVD TargetMapping Version CIM Provider 3 0 CIM Provider 3 0 supports the following commands Download ChangeWWN GetWWNCap GetXcvrData LoadList Loopbacktest GetBeacon SetBeacon ReadWWN Reset RestoreWWN CIM Provider 3 1 CIM Provider 3 1 supports the following commands 4 CLI Client Command Usage CIM Interface All the commands listed in the previous section for CIM Provider 3 0 on page 37 Dump OneCommand Manage
14. Note For OneConnect UCNAs if the core optional parameter is not specified an Enhanced FAT Dump is performed by default Supported By Linux Solaris VMware ESX and Windows Syntax Dump WWPN MAC core Options Parameters WWPN The WWPN of the adapter MAC The MAC address of the UCNA port core Perform a core dump on a OneConnect UCNA Options For available Options contact Emulex technical support GetDumpbDirectory This command shows the dump file directory for the adapters in the host Note The dump directory can be set on VMware ESX hosts only Note The dump directory applies to all adapters in the server There is not a separate dump directory for each adapter Supported By Linux Solaris VMware ESX and Windows Syntax GetDumpDirectory WWPN MAC OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 81 Dump Commands Parameters WWPN The WWPN of the adapter MAC The MAC address of the UCNA port GetDumpFile 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 the local client s dump directory The dump directory local and remote is named Dump and is placed under the OneCommand Manager installation directory The dump files are copied from the Dump directory of the remote host to
15. Only Mode May Cause Error Message on pase 30 Not supported ChangeWWN If a volatile change is reguested on an adapter that does not support volatile WWNs it returns a not supported error See ChangeWWN on page 128 There are no license features for this adapter ShowLicenseAdapterlD InstallAdapterLicense ShowAdapterLicenseFeatures Adapter License Management commands are not available on Ce11101 EM EX or OCe11102 EM EX adapters See Adapter License Management Commands on page 51 ERROR HBACMD GetDumpFile RM GetDumpFile call failed 2 ERROR 2 Not Supported GetDumpFile 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 an error since the source and destination directory are the same See GetDumpFile on page 81 ERROR 180 Authentication User unknown All The specified username is not valid or could not be authenticated by the system See OneCommand Manager Secure Management on page 13 for more information ERROR lt 181 gt Authentication Insufficient credentials All OneCommand Manager Command Line Interface Version 6 3 User Manual The specified username and password are valid and the user is a member of an OCM group however the OCM group does not have sufficient privileges to execute the specified command
16. Rev A is 4 CLI Client Command Usage 32 DG EMULEX Secure Management CLI Interface Secure Management CLI Interface Supported By Linux Solaris and Windows Note Users with root or Administrator privileges on the local machine will retain full OCM CLI configuration capability without the use of credentials local machine only Device Management Using the Secure Management Interface To run the HBACMD CLI client application when the Secure Management feature is enabled each invocation must include a user name and password The user name and password options are added to the existing hbacmd command in a similar fashion as is currently done for CIM commands except the lt m CIM gt option is replaced by the lt m SEC gt option to distinguish it from a CIM command For example Without Secure Management or if running as root or Administrator hbacmd cmd With Secure Management as non Root or non Administrator User hbacmd lt m SEC gt lt u userid gt lt p password gt lt cmd gt Syntax Rules for the Secure Management Interface For the secure management interface all of the syntax rules in HbaCmd Syntax Usage on page 30 apply Additionally the m sec parameter is required in the command for all users without root or Administrator privileges Usage Example In Windows to display a list of adapters managed for a specified host using the secure management interface run the fol
17. See OneCommand Manager Secure Management on page 13 for more information P009403 01A Rev A 2G EMULEX Table A 1 OneCommand Manager Error Messages Continued OneCommand Manager Error Messages Error Message Command s Description ERROR lt 183 gt Secure Mgmt user All The specified username and not a member of OCM group password could be authenticated but the user is not a member of an OCM group See OneCommand Manager Secure Management on page 13 for more information ERROR lt 206 gt Authentication All This indicates either a valid Failed username but invalid password or a general user authentication error See OneCommand Manager Secure Management on page 13 for more information ERROR lt 222 gt DCB not available GetDCBParams These commands are not available SetDCBParam on Ce11101 EM EX or OCe11102 EM EX adapters See GetPGinfo DCB Commands on page 65 SetDCBPriority SetCnaPGBW ERROR lt 251 gt Hardware or firmware SRIOVEnable These commands are not available does not support command UmcGetParams on Ce11101 EM EX or UmcEnabl OCe11102 EM EX adapters See mennan E SRIOVEnable on page 113 and UmcSetLPVID UMC Commands on page 120 UmcSetBW Error lt 431 gt Cable length required SetPhyPortSpeed This error is displayed when a for force mode and interface type OneCommand Manager Command Line Interface Version 6 3 User Manual length valu
18. Solaris VMware ESX and Windows Syntax hbacmd CMSetBW WWPN MAC Address Min0 Max0 lt Minl Max1 gt lt Min2 Max2 gt Min3 Max3 Parameters MAC Address MAC address of any NIC function on the physical adapter port WWPN WWPN of an FCoE function on the physical port Min0 Max0 minimum and maximum band widths for channel 0 Minl Maxi minimum and maximum bandwidths for channel 1 Min2 Max2 minimum and maximum bandwidths for channel 2 Min3 Max3 minimum and maximum bandwidths for channel 3 Examples gt hbacmd CMSetBW 00 00 c9 bb cc aa 25 50 50 75 0 0 25 100 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 65 2c EMULEX DCB Commands For a port with a channel with the specified MAC address this command Sets channel 0 s minimum bandwidth to 25 and maximum to 50 Sets channel 1 s minimum bandwidth to 50 and maximum to 75 Disables channel 2 if UMC Sets channel 3 s minimum bandwidth to 25 and maximum to 100 If UMC channels 0 1 and 3 would be enabled if their previous bandwidths were 0 DCB Commands 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 UCNAs Notes e DCB commands are for DCB management of OneConnect adapters only e DCB or parts of DCB may not always be available on an adapter depending on its configuration For exam
19. Y 171 LoopBackTest Y v Y Y 72 LoopMap Y Y Y Y 73 PciData Y Y Y 4 4 73 PersistentBinding Y Y 116 PortAttributes Y Y Y Y 53 PortStatistics Y Y Y Y 53 PostTest Y Y Y Y 74 ReadWWN Y Y Y Y vl lv Y Y 129 RemoveAllPersistent Y Y 116 Binding RemovePersistent Y Y 117 Binding RemoveHost Y Y Y Y 111 RemoveTarget Y Y Y 94 RemoveTargetPortal Y v Y 95 RescanLuns Y Y Y 106 Reset Y Y v v v v v v Y v 112 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 45 2G EMULEX Table 5 1 CLI Client Command Reference Continued 5 CLI Client Command Descriptions 46 CIM Provider VMWare Command Linux Solaris ESX Windows CIM 3 0 3 1 3 2 3 4 4 3 5 Page RestoreWWN Y Y Y Y Y Y v Y Y Y 129 SaveConfig Y 78 ServerAttributes Y Y Y Y Y 54 SetAuthConfig Y Y Y 58 SetBeacon Y Y Y Y Y Y v v v Y 174 SetBindingSupport Y Y 117 SetBootParam Y Y Y Y 61 SetBootTargetSession Y Y Y Y 95 SetCableNVP Y Y Y Y 75 SetCnaPGBW Y Y Y Y Y viv 66 SetCimCred v 112 SetDCBParam Y Y Y Y 4 67 SetDCBPriority Y Y 4 Y 4 68 SetDriverParam Y Y Y 4 4 78 SetDriverParamDefaults Y Y Y Y Y 79 SetDumpbDirectory Y Y 82 SetFIPParam Y Y Y Y 85 SetlnitiatorProperties Y Y Y 96 SetiSCSIBoot Y Y Y 97 SetLunMask Y Y 106 SetNetwork Y Y Y Y 97 Configuration SetPassword Y Y Y 59 SetPersistentBinding Y Y 118 SetPfcThrottle Y Y
20. a converged conduit for network and storage traffic Each channel has its own unigue MAC address Depending on the type of channel management in effect each channel provides various traffic management and provisioning capabilities such as enabling and disabling minium and maximum transmit rates and VLAN ID in UMC for untagged packets also called the LPVID OCM allows the enabling and disabling of channel management and in the case of UMC vNIC2 the setting of each channel s properties For the VNICI and UFP channel management types OCM will display the channel properties but not allow modification Notes e For IBM adapters UMC mode may be referred to as vNIC2 e There are OCM CLI commands for UMC management that are still available for backward compatibility with existing UMC scripts They cannot be used to manage other channel management types See UMC Commands on page 120 for information on UMC management CMGetParams This command shows the current channel management configuration for an adapter s physical port For UMC configurations the UMCGetParams command can still be used The command s output is the active booted channel management state for the adapter the configured state the configured management mode not applicable if the configured state is disabled and the available channel management modes This is followed by a table showing the por s channels along with their channel properties The Type co
21. any new LUNs Supported By Linux Solaris and Windows Syntax RescanLuns lt HBA WWPN gt lt Target WWPN gt Parameters HBA WWPN The WWPN of the adapter Target WWPN The WWPN of the target SetLunMask This command masks the specified LUNs Supported By Solaris and Windows Syntax SetLunMask lt HBA WWPN gt lt Target WWPN gt lt Option gt lt Lun gt lt LunCount gt lt MaskOp gt Parameters HBA WWPN The WWPN of the adapter Target WWPN The WWPN of the target OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 107 2 EMULEX Miscellaneous Commands Option 0 Get information from the driver 1 Get information from the configuration make persistent 2 Send information to both Lun The starting LUN number LunCount The 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 AddHost This command adds a host to the hosts file for TCP IP management in the OneCommand Manager GUI The adapters for these hosts are also presented by the ListHBAs command Supported By Linux Solaris VMware ESX and Windows Syntax For the RM interface hbacmd AddHost host address Note The h option for specifying an optional IP address or host name after hbacmd is not available for the AddHost comma
22. converged network adapters UCNAs 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 A single operation is performed by entering hbacmd followed by a CLI client command and its possible parameters at the command line Use the OneCommand Manager application to do any of the following OneCommand Manager Secure Management enhances active management security by enabling administrators to define each user s privileges for managing or viewing both local and remote adapters Provide increased flexibility in assigning protocols to individual ports on adapters View and configure Universal Multichannel UMC and view properties of other multi channel types Discover local and remote Emulex and OEM branded Emulex adapters as well as hosts targets virtual ports virtual machines and logical unit numbers LUNs over FC or TCP IP Manage local FC remote and TCP IP accessed adapters Remote TCP IP management of adapters on IPv6 hosts Discover log in to and log out from iSCSI targets Manage Emulex FC iSCSI FCoE and NIC Only Universal Converged Network Adapters UCNAs Manage OneConnect OCe11100 series adapters NIC and iSCSI only Manage adapters on VMware ESX servers through the Common Information Model CIM interface Manage a UCNA s DCB Data Center Bridging settings Manag
23. gt lt EMULEX OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A Emulex Connects Servers Storage and People 2G EMULEX Copyright 2007 2013 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
24. information about the ESX Patch Management activities see the VMware website To install the Emulex CIM Provider ina VMware ESXi 4 1 hypervisor environment use the esxupdate command line utility and perform the following steps 1 Enable Secure Shell SSH on the VMware Visor host 2 Transfer the Emulex CIM Provider zip file to the VMware hypervisor host 3 Log into the VMware hypervisor host and execute the following command all on one line OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 2 Installing and Uninstalling the CLI 24 Windows esxupdate bundle vmware esx provider emulex cim provider 410 3 6 10 1 23578 6 zip nosigcheck maintenancemode update To install the Emulex CIM Provider in a VMware ESXi 5 0 or ESXi 5 1 hypervisor environment use the esxli command line utility and perform the following steps 1 Copy the CIM provider zip file to var log vmware 2 Loginto the VMware hypervisor host and execute the following command all on one line esxcli software vib update d vmware esx provider emulex cim provider 50 3 6 11 1 01 zip no sig check maintenance mode 3 Reboot the system Windows Installing in Windows There are two ways to install the OneCommand Manager CLI in Windows e Attended installation you are present during the installation You will be prompted for more information for the installation to continue e Unattended installation
25. namespace gt lt o port gt Command Summary Help Commands Help lt Group gt Group AdapterLicense Attributes Authentication Boot CEE Channel Management DCB Diagnostics DriverParams Dump AdapterManagement eLunManagement eLunMigration FCoE iSCSI KeyManagerClientManagement LUNMasking Miscellaneous PersistentBinding Personality PolicyManagement OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions Help 49 ServerKeyManagement Adapter Licens ShowLicenseAdapterID Attributes Commands HbaAttributes PortAttributes SetPhyPortSpeed SetPortEnabled Authentication Commands InstallAdapterLicense ServerLicenseManagement UMC VPort WWN Management Commands ShowAdapterLicenseFeatures PortStatistics ServerAttributes AuthConfigList DeleteAuthConfig GetAuthConfig GetAuthStatus InitiateAuth SetAuthConfig SetPassword Boot Commands EnableBootCode GetBootParams SetBootParam CEE Commands LP21000 series only CEEDownload GetCEEParams SetCEEParam Channel Management Commands CMGetParams CMMode CMSetBW DCB Commands GetDCBParams SetDCBParam GetPGInfo SetDCBPriority SetCnaPGBW Diagnostic Commands EchoTest GetBeacon GetXcvrData LoadList LoopBackTest LoopMap PciData PostTest SetBeacon SetCableNVP TDRTest Wakeup Driver P
26. none use for the argument 8 The same priority values cannot be specified to different groups 9 All priorities 0 7 must be assigned to some PGID 10 Not all PGIDs must be assigned a priority 11 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 The following rules are specific to FCoE adapters 1 A minimum of one and a maximum of two PFC priorities can be configured 2 One of the PFC priorities must match the FCoE priority 3 The additional PFC priority must be assigned to a priority group that has no other priorities 4 The FCoE priority must be assigned to a priority group that has no other priorities The following rules are specific to isCSI adapters 1 A minimum of one and a maximum of two PFC priorities can be configured 2 Oneofthe PFC priorities must match the iSCSI priority 3 The additional PFC priority must be assigned to a priority group that has no other priorities 4 The iSCSI priority must be assigned to a priority group that has no other priorities The following rules are specific to NIC adapters 1 Only one PFC priority can be configured 2 The PEC priority must be assigned to a priority group that has no other priorities Supported By Linux Solaris VMware ESX and Windows Syntax hbacmd SetDCBPriority lt WWPN MAC gt PFC Priorities Priorities of PGIDO gt lt Prioriti
27. only manage local adapters similar to the ocmlocaladmin user Remote management operations between two machines is allowed or denied depending on the OneCommand Manager secure management status of the machines and the domains to which the machines belong The following tables list the behavior assuming appropriate user credentials are used Table 1 2 Active Commands machines on same domain Remote Server Remote Server Secure Not Secure Client Secure Allowed Denied Client Not Secure Denied Allowed OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 1 Introduction 15 DG EMULEX OneCommand Manager Secure Management Table 1 3 Active Commands machines on different domain Remote Server Remote Server Secure Not Secure Client Secure Denied Denied Client Not Secure Denied Allowed Table 1 4 Passive Commands machines on any domain Remote Server Remote Server Secure Not Secure Client Secure Allowed Allowed Client Not Secure Allowed Allowed To inform you of an unsecured server that you may want to secure Allowed if the username and password are the same on both domains OCM Secure Management Configuration Requirements For systems to run in the OCM secure management environment they need to be configured to provide the following two capabilities e Authentication On Linux and Solaris this is done through the PAM interf
28. page 15 for configuration instructions For new systems before installing the OneCommand Manager CLI install the specific Linux driver rpm file 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 operating system distribution media e For i386 RHEL 5 5 RHEL 5 6 and RHEL 6 use the 32bit libnl library e Forx86 64 RHEL 5 5 RHEL 5 6 and RHEL 6 use the 64bit libnl library e Foria64 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 before installing the OneCommand Manager CLI download the appropriate Linux driver from the Emulex website and install it If specified also download and install the appropriate library file For example e On OneConnect FCoE adapters o For RHEL 5 and SLES 10 operating systems use Linux driver version 8 2 0 33 3p or later OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 EMULEX 2 Installing and Uninstalling the CLI Linux o For RHEL 6 and later versions and SLES 11 SP1 and later versions operating systems use Linux driver version 8 3 5 Also the RHEL 6 Enterprise kit requires the installation of the libstdc 5 so library This library is available through the compat libstdc 33 3 2 3 68 lt arch gt rpm or later The
29. required in the command line for getting the data from the ESXi host For example hbacmd h IP Address port gt m cim u root p lt password gt n lt namespace gt InstallAdapterLicense 00 12 34 56 78 9A K M1f1324 1ic Note If you specify the parameter m cim the CLI uses the CIM interface to talk to the CIM server running on ESXi 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 Syntax Options and Setting CIM Credentials For issuing CIM based commands two main syntax options are available Option A hbacmd h IP Address port m cim u userid p password n root emulex command lt WWPN gt Option B hbacmd lt h IP Address port lt m cim gt command Before using the option B syntax you must set the CIM credentials by doing one of the following e Setthe default CIM credentials using the SetCimCred command see page 112 This command sets only the CIM credentials Once you have set them subsequent HbaCmd commands do not require you specify the CIM credentials on the command line For example hbacmd SetCimCred username password namespace lt portnum gt e Add the host IP address with CIM credentials using the AddHost command For example OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 4 CLI Client Command Usage 34 2c EMULEX CIM
30. 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 Except for the lt Initiator_Name gt and lt Initiator_Alias gt 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 When you set the authentication method lt Auth gt to a value other than 0 you must set additional parameters Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser Additionally these properties are used for iSNS target discovery to set the discovered target s login properties e If you set the authentication method to One Way CHAP lt Auth gt 1 you must also specify the Target CHAP Name and Target Secret For example hbacmd SetInitiatorProperties 00 11 22 33 44 55 Auth 1 TgtChapName TargetSecretl e If you set the authentication method to Mutual CHAP lt Auth gt 2 you must specify all four values For example hbacmd SetInitiatorProperties 00 11 22 33 44 55 Auth 2 TgtChapName TargetSecretl InitCHAPName InitialSecretl Supported By Linux Solaris VMware ESX and Windows Syntax SetIniti
31. the Dump directory of the local host Therefore 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 2 Not Supported Dump directory e For Windows C Program Files Emulex Util Dump e For Linux usr sbin ocmanager Dump e ForSolaris opt ELXocm Dump e For VMware ESX The dump directory set using the SetDumpDirectory command Supported By Linux Solaris VMware ESX and Windows Syntax GetDumpFile WWPN MAC filename Parameters WWPN The WWPN of the adapter MAC The MAC address of the UCNA port filename The name of the dump file to be copied from the remote host Example hbacmd h 10 192 193 154 m cim u root p Swamiji001 n root emulex getdumpfile BG HBANYWARE 15 10000000c97d1314 20100120 032820421 dmp OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 2G EMULEX Dump Commands nz GetDumpFileNames This command gets the names of the files in the remote host s dump directory Supported By Linux Solaris VMware ESX and Windows Syntax GetDumpFileNames WWPN MAC Parameters WWPN The WWPN of the adapter MAC The MAC address of the UCNA port Example hbacmd h 10 192 193 154 m cim u root p Swamiji001 n root emulex getdumpfilenames GetRetentionCount This com
32. 03 01A Rev A 5 CLI Client Command Descriptions gt lt EMULEX iSCSI Commands B3 Supported By Linux Solaris VMware ESX and Windows Syntax AddTargetPortal MAC Address Target IP Port 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 Parameters MAC Address The MAC address of the UCNA 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 HeaderDigest 0 gt None default 1 CRC32C DataDigest 0 None default 1 CRC32C Auth 0 None default 1 One Way CHAP 2 Mutual CHAP TgtCHAPNam 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 CleariSNSServer This command clears the configured iSNS server and disables iSNS target discovery If no iSNS server is currently configured this command does nothing Supported By Linux Solaris VMware ESX and Windows Syntax CleariSNSServer lt MAC Address gt Parameters MAC Address The MAC address of the UCNA port OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions Q0
33. 2 NIC 00 00 c9 bb cc ac 4 25 50 B NIC 00 00 c9 bb cc ad 5 50 7D NIC Plus Storage gt hbacmd UmcGetParams 00 00 c9 bb cc aa Active UMC State Enabled Configured UMC State Enabled Func Type MAC Address LPVID Min BW Max BW 0 NIC 00 00 c9 bb cc aa 1001 20 50 1 FCoE 00 00 c9 bb cc ab n a 50 100 2 NIC 00 00 c9 bb cc ac 1002 20 50 3 NIC 00 00 c9 bb cc ad 1003 10 75 UmcSetBw This command sets the minimum and maximum bandwidths for each channel up to four on the physical port The total of the minimum bandwidths must add up to 100 The maximum bandwidth must be greater than or equal to the minimum bandwidth and has a maximum value of 100 Setting the minimum bandwidth of a channel to 0 will disable the channel and setting it to a non zero value with enable the channel This command can also be used to disable the link on a channel by setting the minimum and maximum bandwidths of that channel to 0 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX Supported By 5 CLI Client Command Descriptions 123 UMC Commands Linux Solaris VMware ESX and Windows Syntax UmcSetBW lt WWPN MAC Address Min0 Max0 Minl Maxi1 lt Min2 Max2 gt Min3 Max3 Parameters MAC Address WWPN MinO Max0 Minl Maxl Min2 Max2 Min3 Max3 Example MAC address of any NIC function on the adapter port WWPN of the FCoE function on the physical port minimum and maximum bandwidt
34. 3 User Manual P009403 01A Rev A 4 CLI Client Command Usage 31 2G EMULEX HbaCmd Syntax Usage For Linux Solaris and VMware ESX which are case sensitive program names must be in lowercase letters therefore the command line must begin with hbacmd rather than HbaCmd Windows is not case sensitive so the program name is not reguired to be in all lowercase letters An optional IP address or host name can be specified using the h option with the following syntax hbacmd h IP Address port Hostname port lt command gt parameters o If the h option is omitted the command is run on the local host o Ifthe h option is specified the command is sent to the specified remote host assuming it is specified correctly the remote host is up and the remote host is running the OneCommand Manager remote management agent o The port option is optional If omitted the OneCommand Manager remote management protocol uses the default TCP port If specified it uses the user specified TCP port o Examples Using the IP address hbacmd h 138 239 91 121 ListHBAs Using the host name hbacmd h cp hp5670 ListHBAs o The h option is available for all commands except for the AddHost page 107 RemoveHost page 111 and the Version page 114 commands For FC ports the WWPN of the adapter must be specified Where the WWPN is specified each pair of numbers within the WWPN is separated by colons or s
35. 8 SetDriverParamDefaults ccccce cee eeeeeee ti i tirine ne TEE EEEE EEEa 79 Dump Commands i zik dd a vex En Ran RREE REM N FK SEN A i i NEA SR vln k 79 DeleteD trnpFiles 54 cc eer ae avo reae naro ae haee recede eo sae Res Prre e Ee ded Ee 79 DUMP E 80 IE P pbi Crea e M 80 GSIDUmDEIS ssov hu nooo O nn ier RR COP FM Kerr Ed 81 GetDumpFileNa MES aires uses intei t eR Ed cru nn dax P SEP ads 82 GetRetentionCount gem e 82 SEtDLUMPDILECLoN re sro dov v dla av v ees 82 SEtRetentionCoUnt oee esr porte EE E E E RE l ER io Rn ri 83 FCoE COMMANOS iiis n hn S en PE ERN VZ dni va 84 uS VoM ETT IU T UU I n v nd no oi inv 84 GetFIPParams iiec voee rer SR EEEE EEE SEE EF QUE NU KENE FR EV EER MEE EU E SR 84 SetFIPParam i eese RR eh en Ryu V eek n eR eee Ry SEE EES KEVENEE 85 iSCSI Commands P 85 AGHARPTSBIBERU cioe nbi uasa nn v Vu ea rea dd esa a v on Rea dE eed 86 AddRouteTableErtry 5 iuusiisoe eves exa a k Ea ea K EXE REA VAR NR ERR ARE NEUE Tu CREE RA Eu 86 AGA ANSE 4 5 2 eei nn i vegas date FERE NONEIS o Tono 87 AddTareetPortal 5215 b eT er The ea EATER ERR nn 88 CleariSNSServer ieeeee eese enar RI RN saves AREE AREE EVEN SENA NAR EEUU ENTE SEE ee e EN OS 89 DElARPTADIEENLNY z sada sadd andon d ka ky V KON do fo kz von dla kon 90 DelRoUte FableEntr
36. Auth lt 0 1 2 gt TgtCHAPName TgtSecret InitCHAPName InitSecret Parameters MAC Address The MAC address of the UCNA port Target IP The IP address of the target portal Port The port number of the target portal value 1024 65535 ImmediateData 0 No 1 Yes default HeaderDigest 0 gt None default 1 CRC32C DataDigest 0 None default 1 CRC32C Auth 0 None default 1 One Way CHAP 2 Mutual CHAP TgtCHAPNam The Target CHAP name enclosed in quotes string length 1 256 TgtSecret The Target Secret enclosed in quotes string length 12 16 InitCHAPName The Initiator CHAP name enclosed in quotes string length 1 256 InitSecret The Initiator Secret enclosed in quotes string length 12 16 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 101 2 EMULEX iSCSI Commands ShowARPTable This command shows the current ARP table for the specified port Supported By Linux Solaris VMware ESX and Windows Syntax ShowARPTable lt MAC Address gt Parameters MAC Address The MAC address of the UCNA port ShowiSNSServer This command shows the currently configured Internet Storage Name Server This command also indicates whether or not iSNS discovery is enabled Supported By Linux Solaris VMware ESX and Windows Syntax ShowiSNSServer lt MAC Address gt Parameters MAC Address The MAC address of the UCNA port ShowRout
37. Descriptions 130 DG EMULEX WWN Management Commands Notes e A reboot is required to activate the new setting e 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 see the VMware documentation e 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 see the VMware documentation Supported By Linux Solaris VMware ESX and Windows Syntax RestoreWWN lt WWPN gt lt Type gt Parameters WWPN The WWPN of the adapter Type 0 Restore Default WWNs 1 Restore NVRAM WWNs OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX Appendix A OneCommand Manager Error Messages 131 Appendix A OneCommand Manager Error Messages Table A 1 contains a list of some of the error messages that may be encountered during an OCM session Table A 1 OneCommand Manager Error Messages Error Message Command s Description Error Read only management mode The CLI does not allow the is currently set on this host The execution of certain commands reguested command is not permitted when it is configured for read only in this mode mode See CLI in Read
38. Er E AER EXTY REN ERE ES E NRNESSNVERERUENSEVENERVSRES qu Ewa a 121 nelle 122 Ul wrer iubd dp 123 VPort COMMS iss aoc eere e ook x unn rio kor ov NER ER UN KURN EUER RM Ud EIER E ERR EREA NE 125 CreateVPort 125 DeleteVPortss sos is esee e ku ee vu ar RE e EX VERSNS ERWET TREES ERA C EUR SS ARE TERN aes 125 List VFUrctlons 5eeeus ren eer nr RI oval ani VES NER RVE e EE ee eer ur E EFE 126 LISEVMS c 126 LISUVPOR S isc sos sds ES cunts V eis V O a bees seuss 127 VPort AVIES wees oso va u ese rrr S K ln k 127 WWN Management Commands sssscccccccccccccccecssscccssccccceccceesscscccccsssssees 128 CHANGE WWI P nik u non 128 e ComE 129 REAUWWW mer 129 Rest reWWN eerror rriei trite Ee a o Es tema gate es UUENKEN NOU TCU CEN Fe ET Uses gus Dewees 129 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2c EMULEX Table of Contents 9 Appendix A OneCommand Manager Error Messages ceccccccccccccccccscees 131 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 1 Introduction 10 gt G EMULEX Overview 1 Introduction Overview The OneCommand Manager Command Line Interface CLI utility is a comprehensive management utility for Emulex host bus adapters HBAs and universal
39. I Client Command Descriptions 72 Diagnostic Commands Parameters WWPN The WWPN of the adapter LoopBackTest 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 FC ports being managed locally or remotely through TCP IP based management Supported By Linux Solaris VMware ESX and Windows Syntax LoopBackTest WWPN MAC Type Count StopOnError Pattern Parameters WWPN The WWPN of the FC or FCoE port MAC The MAC address of the NIC or iSCSI port Type The type of loopback test to run e 0 PCI loopback test Not supported for OneConnect UCNAs e 1 Internal loopback test Not supported for OneConnect UCNAs e 2 External loopback test requires loopback plug e 3 DMA loopback test Only supported for OneConnect UCNAs This DMA loopback test is not supported via the CIM interface e 4 PHY loopback test Only supported for OneConnect UCNAs e 5 MAC loopback test Only supported for OneConnect UCNAs Count Number of times to run the test Possible values are 1 99 9999 To run the test infinitely use 0 StopOnError Checks if the test must be halted on error 0 No halt 1 Halt Pattern An optional parameter that specifies 1 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
40. Interface hbacmd lt m cim gt u userid p password n namespace AddHost IP Address gt Default CIM Credentials If you specify the command with the CIM method m cim without specifying 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 defaults are used username root password root namespace root emulex portnum 5988 Example of Using the CIM Interface to Display Adapters In Windows to display a list of adapters managed for a specified host using the CIM interface run the following command C Program Files Emulex Util OCManager gt hbacmd h 10 192 113 128 m cim u root p root n root emulex listhbas The output displayed is similar to the following example Manageable HBA List Port WWN 10 00 00 00 c9 6b 62 2b Node WWN 20 00 00 00 c9 6b 62 2b Fabric Name 00 00 00 00 00 00 00 00 Flags 00000000 Host Name eng ma emulex com Mfg Emulex Corporation Serial No BG73539764 Port Number n a Mode Initiator Discovery cim Port WWN 10 00 00 00 c9 6b 62 59 Node WWN 20 00 00 00 c9 6b 62 59 Fabric Name 00 00 00 00 00 00 00 00 Flags 00000000 Host Name eng ma emulex com Mfg Emulex Corporation OneComm
41. Interface Version 6 3 User Manual 1 Introduction 12 Abbreviations Converged Enhanced Ethernet Challenge Handshake Authentication Protocol Common Interface Model Common Information Model Object Manager Cisco Intel Nuova data center bridging exchange command line interface console operating system comma separated values direct attach copper destination ID data center bridging data center bridging exchange Diffie Hellman Diffie Hellman Challenge Handshake Authentication Protocol Extended TimeOut File Allocation Table Fibre Channel Fibre Channel over Ethernet FCoE Initialization Protocol graphical user interface host bus adapter iSCSI Boot Firmware Table Internet Control Message Protocol Internet Protocol internet Small Computer System Interface internet Storage Name Server Link Aggregation Control Protocol link layer discovery protocol LightPulse Fibre Channel Logical Port VLAN ID logical unit number media access control message signaled interrupts maximum transmission unit network file system network interface card or controller N_Port_ID virtualization P009403 01A Rev A 2G EMULEX NVP PFC PGID PGBW PHY POST PXE RHEL RM RPM SAN SCSI SFCB SFP SLES SR IOV SSH TCP TDR UCNA UEFI UFP UMC VPD VPort WWN WWNN WWPN VM XML 1 Introduction 13 OneCommand Manager Secure Management normal velocity of propagation priority based flow control priority group ID priori
42. L Live support RemoveAllPersistentBinding This command removes all persisting bindings for the adapter OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX Supported By Solaris and Windows Syntax RemoveAllPersistentBinding lt WWPN gt Parameters WWPN The WWPN of the adapter RemovePersistentBinding 5 CLI Client Command Descriptions 117 Persistent Binding Commands 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 Supported By Solaris and Windows Syntax RemovePersistentBinding WWPN BindType ID SCSIBus lt SCSITArget gt Parameters WWPN The WWPN of the adapter BindType P Remove binding by WWPN N Remove binding by WWNN D Remove binding by D ID ID The type of ID based on lt BindType gt e Target WWPN if lt BindType gt P e Target WWNN if lt BindType gt N e Target D ID if lt BindType gt D SCSIBus The bus number of the SCSI device SCSITarget The target number of the SCSI device SetBindingSupport This command enables and sets the binding support s for the adapter Supported By Solaris and Windows Syntax SetBindingSupport lt WWPN gt lt BindFlag gt OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX Parameters 5 CLI Client Command Descr
43. LEX Table of Contents 8 edge Po i AT A lo 110 GetVPD PER 110 LISCHBAS ETT 111 REMOVEHOSE E 111 MISIONES ini 112 SetCimCred CELA EDD LTD a 112 EIS ZIEDICERHTEELLOIOLOULIID QD 113 TargetMappIn g eoe ves srci ve cde v EP E RENE OEFN o 113 A cdtieds creel eenia E EEEE wee ees ebesd Coss douwas bes Wd bee seared to ctenseeeewases 114 Persistent Binding Commands ccesecccccccccccccccccecccccccccccccesccceeccccssesees 115 AUNOdelnN O TTC 115 BindingCapabilities eec ese sarete eere teo deese boa i r e e e NUS ES ES 115 Bindina SUpport oceno sis eee suse es ko bv oa ni kon vln P NERE SERI horn an 116 PersistentBINdiNg 5 2 ve aa ka ra 116 Removed PersistentBinding ccccccccccceeeeeesccsceeeeeeeeeeeeeeeseessgaaaeeeeees 116 RemovePersistentBinding cccccccccccceeeeeessccceeeeeeeeeeeeeeesesesgaganenenes 117 SetBindinGSupPOMt Zo csv cons i a Sade eee EE EA NR IEEE KEINE EUN V E EN RES 117 SetPersistentBindIng eere pe e prae e eie aa Te an Pere EE via 118 Personality Change COMMANGS ccesecccccccccccccccccsccccccccccccccccccecccesssccees 119 ChangePersonallty acca 22x55e kr hn AR ERR kus REA RR roski tiski esnik ANE EA ERIA MESA VR YA CARA RG 119 ShowPersonalities oe eero tei eeu ko yere NE e Te SUR En DATE E IET ai 120 UMC COMMANGS Mem 120 UmcEnable eere ttr n y eR eA Oa ERE ERES CREE a ERCC ESAE eS 121 UrmcGetParams eu ey re
44. PPC64 and x86_64 builds require the 64 bit version installed which is installed in usr lib64 The i386 build requires the 32 bit version installed which is installed in usr lib e On OneConnect NIC adapters including iSCSI NIC and FCoE NIC adapters use the NIC driver To install the OneCommand Manager CLI in Linux without an existing OneCommand CLI 1 2 3 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 Change to the core kit directory created in step 3 cd elxocmcore lt supported os gt lt app ver gt lt rel gt Run the install sh script install sh The core kit consists of two or three rpm files for each supported architecture and each supported version of Linux For example 6 e elxocmlibhbaapi rpm on 64 bit platforms that support 32 bit applications there are two of these files e elxocmcore rpm When prompted choose whether or not to enable Secure Management for OneCommand Do you want to enable Secure Management feature for OneCommand s u Enter s to select secure management LDAP NIS OCM group configuration required Enter u to run without secure management default Enter the letter s or u Installing in Linux With an Existing OneCommand CLI Kit Before installing the OneCommand Manager CLI
45. SXi hosts hbacmd ShowLicenseAdapterID 00 12 34 56 78 9A OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 53 Attributes Commands For VMware ESX ESXi hosts hbacmd h IP Address m cim u root p lt password gt n lt namespace gt ShowLicenseAdapterID 00 12 34 56 78 9A Attributes Commands HbaAttributes 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 Supported By Linux Solaris VMware ESX and Windows Syntax HbaAttributes WWPN Parameters h The IP address of the host WWPN The WWPN of the adapter PortAttributes This command shows a list of port attributes for the adapter The type of information listed may vary according to the adapter model Supported By Linux Solaris VMware ESX and Windows Syntax PortAttributes lt WWPN MAC gt Parameters h The IP address of the host WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port PortStatistics This command shows all port statistics for the adapter The type of information listed may vary according to the adapter model OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 5 CLI Client Command Descriptions 54 Attributes Commands Supported By Linux Solaris VMware ESX and Windows Synt
46. See OCM Secure Management Configuration Requirements on page 15 for configuration instructions OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2 Installing and Uninstalling the CLI 21 gt lt EMULEX Solaris Before installing the OneCommand Manager CLI install the appropriate driver e The Solaris FC FCoE inbox driver version emlxs 2 80 8 0 or later or the out of box driver version elxfc 2 85 xx xx must be installed for FC FCoE management e The NIC inbox driver version oce 4 4 173 9 3S or later or the out of box driver version elxnic 4 1 xx xx must be installed for UCNA management Note If Emulex OneConnect UCNAs are installed on the system the NIC driver must be installed and reporting all NIC ports Otherwise the OneCommand Manager application cannot manage UCNAs To install the OneCommand Manager CLI in Solaris 1 2 Copy the OneCommand Manager core kit to a temporary directory on the system Untar the core kit by typing tar xvf elxocmcore solaris lt kit version gt tar Change to the newly created elxocmcore solaris lt kit version gt directory cd elxocmcore solaris kit version gt Run the install script and follow the instructions install If any of the 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 utili
47. WWPN WWPN of an FCoE function on the physical port OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 64 Channel Management Commands 2G EMULEX MAC MAC address of any NIC function on the physical adapter port Type Specify None to disable channel management or a channel management type see CMGetParams to enable channel management Example gt hbacmd CMMode 00 00 c9 bb cc aa None This example disables channel management on an adapter containing a NIC function with a MAC address of 00 00 c9 ad ad aa CMSetBW This command sets the minimum and maximum bandwidths for each channel up to four on the physical port For UMC configurations this command can also be used to enable or disable a channel For UMC the UMCSetBW command can still be used instead of this command The total of the minimum bandwidths must add up to 100 The maximum bandwidths must be greater than or equal to the minimum bandwidth and has a maximum of 100 A reboot is not required to make these changes take effect when channel management is enabled For UMC mode you can disable a channel logical link state down by setting the minimum bandwidth and maximum to 0 Setting the minimum bandwidth to a value greater than 0 will enable the channel if it was previously disabled Note This command will fail if the current channel management mode is vNIC1 or UFP Supported By Linux
48. 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 Supported By Linux Solaris VMware ESX and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 109 Miscellaneous Commands Syntax Download lt WWPN MAC gt lt FileName gt Parameters WWPN The WWPN of the adapter port 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 ExportSANInfo For reporting purposes this command captures the SAN information in xml for XML formatted files and csv for CSV formatted files Since this command can output a large amount of information Emulex recommends that you re direct the output to a file 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 Linux Solaris VMware ESX and Windows Syntax ExportSANInfo format Note The h option for specifying an optional IP address or host name after hbacmd is not available for the ExportSANlnfo command Parameters format An optional parameter that specifies the format of the adapter information e CSV e xml Note Leaving t
49. Y Y v 54 SetPhyPortSpeed Y Y Y Y Y Y 55 SetPortEnabled Y v Y Y Y 56 SetRetentionCount Y Y Y Y Y v v Y Y 83 SetTargetLogin Y Y Y Y 98 Properties SetTargetProperties Y Y v Y 99 SetTPLoginProperties 99 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX Table 5 1 CLI Client Command Reference Continued 5 CLI Client Command Descriptions CIM Provider VMWare Command Linux Solaris ESX Windows CIM 3 0 3 1 3 2 3 4 4 3 5 Page ShowAdapterLicense Y Y Y Y Y Y Y Y 52 Features ShowARPTable Y Y Y Y 101 ShowiSNSServer v Y Y Y 101 ShowLicenseAdapterID Y Y Y Y 52 ShowPersonalities Y Y Y Y 120 ShowRouteTable Y Y Y Y 101 ShowTarget Y Y Y Y 102 ShowTargetPortal Y Y Y Y 102 SRIOVEnable Y Y Y v 113 TargetLogin Y Y Y Y 102 TargetLogout Y Y Y Y 104 TargetMapping Y Y Y Y Y 113 TDRTest Y Y Y Y 75 UmcEnable Y Y Y Y Y 121 UmcGetParams Y Y Y Y v 121 UmcSetBw Y Y Y Y Y 122 UmcSetLPVID Y Y Y Y Y 123 UpdateiSNSServer Y Y Y Y 104 Version Y Y Y Y Y 114 VPortTargets Y Y Y Y 127 Wakeup Y Y Y Y 76 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 47 5 CLI Client Command Descriptions DE EMULEX Fe Help The Help command displays command information for the HbaCmd application Without using its optional parameters the He
50. a host name or an IP address which will be validated by the installer An error message appears if mmode is set as Local Only or Management Host e excl This optional switch allows the non management host user to select whether the OneCommand Manager application will process requests OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 2 Installing and Uninstalling the CLI 26 2G EMULEX Windows exclusively from the Management Host specified by the MHost switch This option is only accepted if accompanied by a valid MHost value otherwise an error message appears If this switch is not specified the default value of 0 will be used If the switch is specified the valid values are 0 Remotely managed by other hosts 1 Remotely managed by Management Host ONLY e Mtcp This optional switch allows you to enable or disable remote management and to specify the TCP IP port number over which management will occur If this switch is not specified the default TCP IP port number 2333 will be used If the management host option is selected you must either select the default port number or enter a valid TCP IP port number on the command line A value of 0 will not be accepted If one of the non management host options is selected you can enter the TCP IP port number on the command line Uninstalling in Windows There are two ways to uninstall the OneCommand Manager CLI in Windows e Through the contro
51. ace and must be configured as follows o On Solaris place the correct setting in the auth section of the etc pam d other file or its earlier equivalent etc pam conf Note For Solaris systems you must use useradd G groupname for authentication to work You cannot use a lowercase g o On Linux itis the etc pam d passwd file auth section or the equivalent e User Group Membership From the host machine OCM Secure Management must be able to access the OCM group to which the user belongs For Linux and Solaris systems it uses the getgrnam and getgrid C library API calls The equivalent to the API calls can be obtained by typing getent group from the shell command line If the four OCM group names are listed with their member users the machine is ready to use OCM secure management Secure Management Installation The enabling or disabling of the Secure Management feature is specified at OCM installation time This can be done either interactively or by using dedicated install switches on Windows Linux and Solaris On Linux and Solaris if the OCM groups described above are not configured on the machine at the time of the OCM installation installation will fail when the secure management feature is selected Note Only a user with Administrator Root privileges is allowed to either enable or disable the secure management feature on a local host machine OneCommand Manager Command Line Interface Version
52. ageable 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 Supported By Linux Solaris VMware ESX and Windows Syntax listhbas local m model pt type down Parameters local Only display local adapters m model Model filter Append to the end of the model name for a wildcard match For example LP9 pt type The port type filter Valid types are NIC iSCSI FC and FCoE down Display only the NIC functions of inoperative OneConnect UCNAs on the local system RemoveHost This command removes a host from the hosts file use for TCP IP management in the OneCommand Manager application GUI The lt host_address gt can be an IP address using the IPv4 or IPv6 format or a host name Supported By Linux Solaris VMware ESX and Windows Syntax For the RM interface hbacmd RemoveHost host address For VMware ESX ESXi using the CIM interface OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 5 CLI Client Command Descriptions 112 Miscellaneous Commands hbacmd m cim removehost lt IP Address gt Note The h option for specifying an optional IP address or host name after hbacmd is not available for the RemoveHos
53. and for the cable that connects to the physical port associated with the WWPN or MAC Supported By Linux Solaris VMware ESX and Windows Syntax SetCableNVP lt WWPN MAC gt lt NVP gt Parameters WWPN The WWPN of the FC port MAC The 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 TDRTest Note This command is supported on OneConnect adapters only The TDR test attempts to determine if any cable faults are compromising the integrity of the link For each twisted pair cable labeled A B C or D e Ifa fault cannot be detected the test output displays OK and an estimated cable length in meters if possible If the length cannot be determined the estimated length is displayed as invalid e If one of two faults a short or an open connection is detected the test output displays the fault type Shorted or Open and the distance to the fault in meters Supported By Linux Solaris VMware ESX and Windows Syntax TDRTest MAC Address Parameters MAC Address The MAC address of the NIC or iSCSI port Example hbacmd TDRTest MAC OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 76 gt lt EMULEX Driver Parameter Commands The example output Pair A OK Cable Length Estimation 50m Pair B OK Cable Leng
54. and Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 4 CLI Client Command Usage CIM Interface DE EMULEX 35 BG73539764 n a Serial No Port Number Mode Initiator Discovery cim C Program Files 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 Port Attributes for 10 00 00 00 c9 6b 62 2b 20 00 10 00 Symname FCID 0000 Type Fabric State Service Type 00 00 c9 6b 62 2b 00 00 c9 6b 62 2b Node WWN Port WWN Port Port Port Port Unknown Port 12 vNIC vNIC vNIC vNIC Port Name Outer VLAN ID Bandwidth Max Bandwidth Supported FC4 00 00 01 20 00 00 00 01 Min 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FC4 00 00 01 00 00 00 00 01 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 Port Active 00 00 00 OS Device Name Num Discovered Ports 0 Fabric Name 00 00 00 00 00 00 00 00 For a list of HbaCmd commands supported through the CIM interface see CLI Client Commands Supported in CIM Interface on page 35 CLI Client Commands Supported in CIM Interface Following is a list of HbaCmd commands supported through the CIM interface e AddHost e AllNodelnfo e CEEDownload OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 4 CLI Client Command Usage 36 2c
55. arameter Commands DriverConfig GetDriverParams SetDriverParam SetDriverParamD Dump Commands DeleteDumpFiles Dump GetDumpD GetRetentionCount SetRetention FCoE GetFIPParams Commands SetFIPParam GetF iSCSI Commands AddARPTablel CleariSNSServer ExportiSCSI AddRouteTable DelARPTable GetInitiatorProper GetSes RemoveTarget Rem Entry E Ent GetNetworkConfiguration ListSessions GetDriverParamsGlobal SaveConfig efaults irectory SetDumpDirectory Count GetDumpFileNames GetDumpFile CFInfo Entry ry ties AddTarget DelRouteTableEntry DiscoveriSNSServer GetiSCSILuns GetiSCSIPortStats ImportiSCSI iSCSIPing AddTargetPortal sionInfo Setiscs SetTa SetInitiatorProperties SetTargetLoginProperties oveTargetPortal IBoot SetBootTargetSession SetNetworkConfiguration OneCommand Manager Command Line Interface Version 6 3 User rgetProperties SetTPLoginProperties Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 50 Help ShowARPTable ShowRouteTable ShowTarget ShowTargetPortal TargetLogin ShowiSNSServer TargetLogout UpdateiSNSServer LUN Masking Commands GetLunList GetLunUnmaskByHba GetLunUnmaskByTarget RescanLuns SetLunMask Miscellaneous Commands AddHost CnaGetEventLog CnaClearEventLog Download SRIOVEnable ListVFunctions RemoveHost Reset SetCimCred S
56. arameters physical WWPN The WWPN of the object adapter auto The virtual WWPN is automatically generated for the virtual port vname The virtual por s name optional virtual WWPN The virtual WWPN to create virtual WWNN The virtual WWNN to create DeleteVPort This command deletes the virtual port specified by a physical and virtual WWPN Supported By Linux Solaris and Windows Syntax DeleteVPort lt physical WWPN gt lt virtual WWPN gt OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX S CLI Client Command Descriptions 126 VPort Commands Parameters physical WWPN The WWPN of the adapter virtual WWPN The WWPN of the virtual port ListVFunctions This command lists the virtual functions on a specified NIC port that is physical function Supported By Linux Solaris VMware ESX and Windows Syntax ListVFunctions lt MAC gt Parameters MAC The MAC address of the port Example hbacmd ListVFunctions 00 00 c9 12 34 56 The example output Virtual Functions for 00 00 c9 12 34 56 MAC Address 00 00 c9 12 34 ab VLADID Transmit Rate MAC Address VLADID Transmit Rate MAC Address VLADID Transmit Rate MAC Address VLADID Transmit Rate 10 100 Mbit sec 00 00 c9 12 34 cd 10 100 Mbit sec 00 00 c9 12 34 ef 10 1 bbit sec 00 00 c9 13 34 01 20 1 Gbit sec List VMs This command lists all virtual machines and their information for a
57. arated list where multiple PFC priorities supported 4 Specifying defaults for the Param argument sets all DCB parameters including Priority Groups to their default values Ex SetDCBParams lt WWPN MAC gt defaults Adapter License Management Commands Notes e Adapter License Management commands are supported on OneConnect adapters only These commands are not available on LP1600x adapters e These commands are not available on OCe11101 EM EX or OCe11102 EM EX adapters The following error message will be returned There are no license features for this adapter In these commands the WWPN or MAC address argument specifies the adapter the command is acting upon The the HbaCmd application uses the WWPN or MAC address to identify the adapter but this does not mean that the command works successfully on the specified port InstallAdapterLicense This command installs the license keys from a license file to enable specific features on the adapter Supported By Linux Solaris VMware ESX and Windows Syntax InstallAdapterLicense WWPN MAC LicenseFile Parameters WWPN The FCoE port WWPN of the adapter MAC The NIC or iSCSI port address of the adapter License File The path to the license key file containing the license keys obtained from the Emulex License website Examples For non VMware ESX ESXi hosts hbacmd InstallAdapterLicense 00 12 34 56 78 9A K 1f1324 lic For VMware ESX ESXi hosts hbacmd h IP A
58. atorProperties MAC Address 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 InitSecret Parameters MAC Address The MAC address of the UCNA port Initiator Name Initiator iSCSI name enclosed in quotes string length 1 224 Initiator Alias Initiator iSCSI alias enclosed in quotes string length 0 32 ImmediateData 0 No 1 Yes default OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 97 2c EMULEX iSCSI Commands HeaderDigest 0 None default 1 CRC32C DataDigest 0 None default 1 CRC32C Auth 0 None default 1 One Way CHAP 2 Mutual CHAP TgtCHAPNam 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 SetiSCSIBoot This command defines whether a specific iSCSI function s Boot ROM is active Supported By Linux Solaris VMware ESX and Windows Syntax SetiSCSIBoot MAC Address lt 0 1 gt Parameters MAC Address The MAC address of the desired iSCSI port 011 Specifies the iSCSI boot ROM state 0 Disabled 1 Enabled SetNetworkConfiguration
59. ax PortStatistics lt WWPN gt Parameters WWPN The WWPN of the adapter ServerAttributes This command shows a list of server attributes for the adapter The type of information listed may vary according to the adapter model Supported By Linux Solaris VMware ESX and Windows Syntax ServerAttributes lt WWPN MAC gt Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port SetPfcThrottle This command returns the PFC Throttle state as enabled or disabled Note The PFC Throttle state returns when using the PortAttributes command for OneConnect OCe10102 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 Linux Solaris VMware ESX and Windows Syntax SetPfcThrottle WWPN 0 1 Parameters WWPN The WWPN of the adapter OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 55 Attributes Commands 011 The PFC throttle state 0 Disabled 1 Enabled SetPhyPortSpeed This command sets the port speed on OneConnect OCe11100 series adapters only Supported By Linux Solaris VMware ESX and Windows Syntax SetPhyPortSpeed lt WWPN MAC gt lt Mode gt Speed Length Parameters WWPN The WWPN of the FCoE port MAC The MAC addr
60. baease ve e Pesun bo oie ni 53 PORCSCATISCIGS 3 2 rm 53 SErVeErAteri DUtes vz iis svo 54 SetPfcThrottle ioo e teer ed ro lord on ia 54 SetPhyPOrtS peed cien cesare ed Eder nba hok dr tro look 55 SetPortEnabled 2 5 rere sot x E ERN ursa CE Vo ue ERAN EVA v 56 Authentication Commands saspe plex ovi nr oo ik ir ob va 56 5 MCONTMBUISE os sucanenamevucneiadeaetantdaasdaniscunermectdewsewhenenaedentenidaadenianiensents 56 DeleteAuthConfig ci cag sk ka ss evens vende KANOE K io on Kovov v 57 GB CAUT HC ON oso Col ees kdo c ono hlavn o osol ooo n 57 GetAuthiStatus veo eoa es rr Rr ee E ERR ET EEEPERUEN EE NETS PS SUE EEERRRN A KEEN RAE U ERE ER RES 57 InitiateAUth is 446606 rer canes REN REIS SE ERES E SENE cates ARE UNES Ti 58 SODAUEhC OTI opus Era Do Eve pud beo oo DO V vvn 58 Set PassWOFG acceso sese eu n sure eR Ree ARES EE P ONU S EST NC I UE E REN KT dS E bU EQUUS 59 Boot Cominarids sucede ni kanonik Zda hn 60 EnableBOotCod Cr RCM 60 GetBootPaLtalns eee ee eere E EE VU E RE r rana 61 SetBootParam ceeds exe eeu ones stiihia ER e noe EE eve lino 61 CEE COmmalids zod las vk RRERERRNEERENU ERR or o ANE ARR REMO MEE 62 Channel Management Commands ccssscccccscccccccsscccccsssscccccsscscesssssssesseces 62 GET SELECTIS DO DLL 62 E dst EEE 63 CMSetBW P tens 64 DCE COmManS e 65 GetDCBPATAMS sii cic
61. bamgrd 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 UCNA management requests The daemon processes start at system boot time VMware ESX Server Starting Daemon Processes To start the OneCommand Manager daemon in VMware ESX 4 1 1 Login as root 2 Change to the OneCommand Manager directory cd usr sbin ocmanager 3 Start the OneCommand Manager daemon start ocmanager Stopping Daemon Processes To stop the OneCommand Manager daemon in VMware ESX 4 1 1 Login as root 2 Goto the OneCommand Manager directory cd usr sbin ocmanager 3 Stop the OneCommand Manager daemon stop ocmanager OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A ys 3 Updating to the OneCommand Manager Application Enterprise Kit 28 DE EMULEX qum 3 Updating to the OneCommand Manager Application Enterprise Kit Note The full featured OneCommand Manager application enterprise kit is not supported on Citrix XenServer 5 6 SP2 Citrix XenServer 6 0 or VMware ESX server This chapter details procedures for updating the OneCommand Manager CLI to the OneCommand Manager Application Enterprise kit in Linux Solaris and Windows operating systems An update can be performed only if the version of the OneCommand Manager application enterprise kit i
62. d as the first argument OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 86 2 EMULEX iSCSI Commands Some commands require values to be set in a format similar to option name value Type the full option name or the abbreviated option name shown in Table 5 2 Option Names and enter the value The abbreviations are not case sensitive Table 5 2 Option Names Option Name Abbreviation Example Auth au au 1 DataDigest dd dd 1 DHCP dh dh 1 HeaderDigest hd hd 1 ImmediateData id id 1 Initiator_Alias ia ia initiator alias Initiator_Name in in initiator name Priority pr pr 1 VLAN_ENABLED ve ve 1 VLAN ID vi vi 1 AddARPTableEntry This command adds an ARP table entry Supported By Linux Solaris VMware ESX and Windows Syntax AddARPTableEntry MAC Address Dest MAC Address Dest IP Address Parameters MAC Address The MAC address of the UCNA port Dest MAC Address The destination MAC address to add to the ARP table Dest IP Address The destination IP address to add to the ARP table AddRouteTableEntry This command adds a new route table entry to the route table of the specified port Supported By Linux Solaris VMware ESX and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 87 2 EMULEX iSCSI Command
63. ddress m cim u root p password n lt namespace gt InstallAdapterLicense 00 12 34 56 78 9A K 1f 1324 lic OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 52 Adapter License Management Commands ShowAdapterLicenseFeatures 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 Supported By Linux Solaris VMware ESX and Windows Syntax ShowAdapterLicenseFeatures lt WWPN MAC gt Parameters WWPN The FCoE port WWPN of the adapter MAC The NIC or iSCSI port address of the adapter Examples For non VMware ESX ESXi hosts hbacmd ShowAdapterLicenseFeatures 00 12 34 56 78 9A For VMware ESX ESXi hosts hbacmd h IP Address m cim u root p password n lt namespace gt ShowAdapterLicenseFeatures 00 12 34 56 78 9A ShowAdapterLicenselD 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 Supported By Linux Solaris VMware ESX and Windows Syntax ShowLicenseAdapterID lt WWPN MAC gt Parameters WWPN The FCoE port WWPN of the adapter MAC The NIC or iSCSI port address of the adapter Examples For non VMware ESX E
64. defaults Description and Value The DCBX protocol state 0 Disabled 1 Enabled The DCBX mode DCB or CIN 0 CIN 1 DCB The lt DCBXmode gt also configures the FIP mode If lt DCBXmode gt DCB FIP is enabled If lt DCBXmode gt CIN FIP is disabled Flow control in both directions transmit and receive 0 Disabled 1 Enabled ity This parameter is applicable for FCoE adapters only A single priority must be specified The range of valid values is 0 7 rity This parameter is applicable for iSCSI adapters only A single priority must be specified The range of valid values is 0 7 ty A list of comma separated values where multiple PFC priorities supported The comma separated list can contain up to seven values ranging from 0 7 Use to set the UCNA DCB parameters including priority groups to their default values For example hbacmd SetDCBParam lt WWPN MAC gt defaults OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 68 DCB Commands LLDP Settings for lt Param gt and lt Value gt lt Param gt TxState RxState TxPortDesc TxSysDesc TxSysName TxSysCap Example hbacmd h 10 Description and lt Value gt Transmit State DCBX uses 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
65. e 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 HBAnyware Kits in Linux on page 20 Performing a Clean Install Removing Existing Settings 1 Uninstall the existing OneCommand Manager CLI using the uninstall script included in the tar file or in usr sbin ocmanager scripts directory Your configuration files are backed up by rpm with an rpmsave extension Note If an HBAnyware CLI or enterprise kit is installed follow the procedure for Uninstalling Older HBAnyware Kits in Linux on page 20 2 Install the specific rpm file for your driver for Linux version For information on installing the rpm file see Installing in Linux Without an Existing OneCommand CLI Kit on page 17 Uninstalling in Linux To uninstall the OneCommand Manager CLI in Linux 1 Loginas root 2 Doone of the following e Run the uninstall ocmanager sh script located in usr sbin hbanyware scripts e Runtheuninstall sh script located in the installation tar file OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 2 Installing and Uninstalling the CLI 20 Solaris Uninstalling Older HBAnyware Kits in Linux Uninstalling an Older HBAnyware Core Kit 1 Run the following command to remove
66. e a UCNA s Fibre Channel over Ethernet FCoE Initialization Protocol FIP Manage adapter licenses Manage protocol personalities Group hosts for easier parameter configuration and firmware download Retrieve adapter dump files from remote hosts Change an adapter s World Wide Port Name WWPN and World Wide Node Name WWNN Reset FC ports Configure persistent binding on FC targets OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 1 Introduction gt lt EMULEX Abbreviations H e SetFC FCoE adapter driver parameters simultaneously to multiple adapters using Batch Update e Update firmware and FC boot code x86 BootBIOS OpenBoot or EFIBoot on a single adapter or multiple adapters using Batch Update e Set global FC FCoE driver parameters e Enable or disable adapter boot x86 BootBIOS FCode EFIBoot or PXE Boot e Run diagnostic tests on adapter ports e Locate adapter ports using beaconing e Mask and unmask FC LUNs e Create and delete FC virtual ports through N_Port_ID virtualization NPIV e View FC virtual ports and virtual machine mapping information e Configure FC boot from SAN e Modify an IP port number of the remote management agent e View vital product data VPD for the selected adapter port e View transceiver information for the selected adapter port e View iSCSI target session information e View vNIC data for supported adapters e Create and save reports about disco
67. e any changes to the target portal s login properties OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is S CLI Client Command Descriptions 100 2 EMULEX iSCSI Commands 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 When you set the authentication method lt Auth gt to a value other than 0 you must set additional parameters Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser e If you set the authentication method to One Way CHAP lt Auth gt 1 you must also specify the Target CHAP Name and Target Secret For example hbacmd SetTPLoginProperties 00 11 22 33 44 55 10 192 1 1 5050 Auth 1 TgtChapName TargetSecret1 e If you set the authentication method to Mutual CHAP lt Auth gt 2 you must specify all four values For example hbacmd SetTPLoginProperties 00 11 22 33 44 55 10 192 1 1 5050 Auth 2 TgtChapName TargetSecreti InitCHAPName InitialSecretl Supported By Linux Solaris VMware ESX and Windows Syntax SetTPLoginProperties lt MAC Address gt lt Target 1P gt lt Port gt ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 0 1 gt
68. e gt p lt password gt n lt namespace gt setdumpdirectory lt DumpDirectoryName gt Parameters DumpDirectoryName The directory under vmfs volumes that you created to store the dump files h The IP address of the host Example This example shows the dump directory set to vmfs volumes ocm datastore hbacmd h 10 192 203 173 m cim u root p Swamiji001 n root emulex setdumpdirectory 10 00 00 00 c9 61 2 64 ocm datastore SetRetentionCount 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 Supported By Linux Solaris VMware ESX and Windows Syntax SetRetentionCount WWPN MAC Value Parameters WWPN The WWPN of the adapter MAC The MAC address of the UCNA port Value The number of dump files to retain OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 5 CLI Client Command Descriptions 84 FCoE Commands 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 This command shows the FCF information of the OneConnect adapter in FCoE mode Supported By Linux Solaris VMware ESX and Windows Syntax GetFCFInfo WWPN Parameter
69. e is not included when the mode is set to 2 Example hbacmd setphyportspeed 00 00 c9 a9 41 88 2 100Mb See Examples on page 55 P009403 01A Rev A 132
70. eTable This command shows the route table for a specific port Supported By Linux Solaris VMware ESX and Windows Syntax ShowRouteTable lt MAC Address gt Parameters MAC Address The MAC address of the UCNA port Example hbacmd h 10 192 203 240 showroutetableentry 00 00 c9 a0 ce 77 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is S CLI Client Command Descriptions 102 2 EMULEX iSCSI Commands ShowTarget 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 lt refreshtargets gt in place of the lt iscsi_target_name gt all targets are refreshed before returning the information If you do not provide a lt iscsi_target_name gt or lt refreshtargets gt value only the targets from the last refresh are displayed Supported By Linux Solaris VMware ESX and Windows Syntax ShowTarget MAC Address lt iscsi target name gt refreshtargets Note Only one command option can be specified with this command That is you can only specify either lt iscsi_target_name gt or lt refreshtargets gt Parameters MAC Address The MAC address of the UCNA port iscsi target name The target s iSCSI name enclosed in quotes string length 11 255 refreshtargets Refresh all targets before displaying the information ShowTargetPortal Th
71. eTargetPortal MAC Address Target IP Port Parameters MAC Address The MAC address of the UCNA port Target IP The target s IP address Port The port number of the target portal The possible values are 1024 65535 SetBootTargetSession This command enables and disables a iSCSI targe s session as a boot session If a session is enabled as a boot session and when the system reboots it will attempt to boot from that target Depending on whether the target is logged in there are two different ways to specify the session If the target is logged in use the lt TSIH gt parameter If the target is not logged in use the lt ISID Qual Target IP parameter Supported By Linux Solaris VMware ESX and Windows Syntax SetBootTargetSession MAC Address Target TSIH ISID Qual Target IP lt 0 1 gt Parameters MAC Address The MAC address of the desired iSCSI port Target Specifies the isCSI name of the desired iSCSI target TSIH TSIH value of the session The possible values are 1 65535 ISID Qual ISID qualifier of the session The possible values are 0 65535 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 96 2 EMULEX iSCSI Commands 011 Specifies the state of the BootProperty for the target 0 Disabled 1 Enabled SetlnitiatorProperties This command sets the initiator properties for the specified port It allows you to
72. ec argument is not entered Secure Management is disabled by default See OneCommand Manager Secure Management on page 13 for more information To enable Secure Management at the command prompt type elxocm windows x64 5 01 00 10 4 exe sec 1 q2 To disable Secure Management at the command prompt type elxocm windows x64 5 01 00 10 4 exe sec 0 q2 5 Youcan select a Management Mode by adding the mmode argument and the ability to change that Management Mode by adding the change argument with selected values as in the example below Note If you enabled Secure Management in Step 4 you cannot enter an mmode value Doing so will result in a conflicting parameters error For example at the command prompt type elxocm windows x64 5 01 00 10 4 exe mmode 3 achange 1 q2 The following are the possible mmode values 1 Local Only Management Mode 2 Local Plus Management Mode 3 Full Management Mode 4 Local Plus Management Mode and Read Only 5 Full Management Mode and Read Only 6 Management host The following are the possible achange values 0 Do not allow Management Mode to change 1 Allow Management Mode to change You can also set the following optional parameters e MHost This optional switch allows a non management host user to select a Management Host with which to register If this switch is not specified the default value of 0 will be used and the capability will be disabled If the switch is specified the value can be
73. eee se tee edes eoa a rope o voda a ini 15 LINUX and Solaris iere erro ee Doy eara v Dore e E reve DUPUEx wea Ve navrhn 16 WINGOWS pe RETE 16 Using OneCommand Manager with Secure Management Enabled 16 2 Installing and Uninstalling the CLI ooooooooonoooooos ooo eene nennen 17 Efe PR 17 Bdpqu 17 Installing in Linux Without an Existing OneCommand CLI Kit oooooonno o 17 Installing in Linux With an Existing OneCommand CLI Kit cece cee eee eee ewes 18 Updating Preserving Existing Settings ccc cce cece eee ee eee seeeeeeeeeeeeeeeeeeeeeeees 19 Performing a Clean Install Removing Existing Settings s cesses eeeeeeeee eens 19 Uninstalling in IU caia serai edu d ades pP ER dede xau drago ipud aate dera La auru adi E 19 Uninstalling Older HBAnyware Kits in Linux eeeeeeeeeeeene nnne 20 Eig Eee tI Too bota Ts o E i a in 20 Installing in Salapisiies i icesusd itti trade idee tacta an in li ki nl na bud 20 Uninstalling in Solaris usieoso voa eorr vad in RE VE hk V ERR dE adul duas E EVER 21 VMware ESX ESXI isausksi ewEpERFRERFPA SERO E a ni EN PI EE EE EzR RAN EIN AR 22 Installing in a New VMware ESX Server cesseeeeeeee eee nnn nnne 22 Installing in a VMware ESX Server with an Existing HBAnyware or OneComma
74. er type of the host platform adapter Supported By Linux VMware ESX and Windows Syntax DriverConfig lt WWPN gt lt FileName gt lt Flag gt Parameters WWPN The WWPN of the adapter FileName The name of the dpv file which is stored in the Emulex Repository directory Flag G gt Make change global all adapters on this host N Make change non global adapter specific GetDriverParams This command shows the name and values of each parameter Supported By Linux Solaris VMware ESX and Windows Syntax GetDriverParams lt WWPN gt Parameters WWPN The WWPN of the adapter GetDriverParamsGlobal This command shows the name and the global value of each driver parameter Supported By Linux Solaris VMware ESX and Windows Syntax GetDriverParamsGlobal lt WWPN gt Parameters WWPN The WWPN of the adapter OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 78 Driver Parameter Commands SaveConfig 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 has the following syntax 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 Supported B
75. es of PGID1 Priorities of PGID7 gt Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port PFCPriorities The PFC priority that is a comma separated list of up to seven values ranging from 0 7 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX Priorities of PGID Example 5 CLI Client Command Descriptions 70 Diagnostic Commands Priority group membership that is a comma separated list of priorities ranging from 0 7 Each set of priorities for a group must be separated by a space All priorities 0 7 must be assigned to some PGID hbacmd h 10 192 203 151 m cim setdcbpriority 10 00 00 00 c9 3c 7 88 3 0 1 2 4 5 6 7 3 0 0 0 0 0 0 Diagnostic Commands EchoTest This command runs the echo test on adapters Notes e This command is not supported for OneConnect adapters e Support for remote adapter is TCP IP access only The EchoTest command fails if the target WWPN does not support the ECHO ELS command Supported By Linux Solaris VMware ESX and Windows Syntax lt Pattern gt Parameters WWPN Source WWPN Destination Count StopOnError Pattern GetBeacon EchoTest lt WWPN Source gt lt WWPN Destination gt lt Count gt lt StopOnError gt The WWPN of the originating adapter The WWPN of the destination echoing adapter The number of times to run the test Use 0 to run the test indefinitely C
76. escacsacuececeaee sense sseves deve sdueecdueectaseoetaee dees SCENENE EEEE E 65 edens 66 Set CHaPGBW iiis e e EE e EP PNEU SEE EO FINES See a 66 SetDCBParam 5 e eee ree e yr erre tristi red vision are Rege es ree RE 67 SetDCBPrIOFIDy stoka s o bi rii e pe e eR aw Ra VE eg EY ee Er DU PRA Ve el gue EV a 68 Diagnostic Commands eror ee so Ep recess slan v pr s dovi dl bis na sia eU E Ti 70 Je T M m 70 GELBEACOM vivian RR 70 GetXcviDat nnee rir nipa L HM 71 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2c EMULEX Table of Contents 6 rab s ra kv ol i I i TN i 71 OoOPBAckKT ES sos s k ra ea wees ES E Ix Y VEN 72 lore tlg TM 73 PeiDA A Em 73 POSUT le P 74 SELBEAGONM ow 74 SECCADIENVP 2 ders ive e re EE EE RENE AERE v A EN ir E VE E Te Eye ees 75 TORTES oei o te eta v 75 MEL CI HR 76 Driver Parameter Commands s 5 okror ve vas boho dk kal no ERA iR sku hy on ir ini 76 PRISE T ana UU TUM 77 GetDriverParams 2 eee ee re Re Pe EP E IO eR ee EE NO AREE ETE TRUE la liana 77 GetDriverParamsGlobal ccccc cece eee eseeeeeeeeeeeeeeeeeesseseeeeeeeeeeeeeeeesgeaaes 77 SAVECONIIG sssadiz kdovvan u T T T I TNT 78 SetDriverPar tm siieceesus eive a Y TE Y dea cess ERU SA E REN EN AS POD ER RE RS PP TN Pe E sees 7
77. ess of the CNA port Mode The Mode number 0 Default 1 Auto negotiate requires the lt Speed gt argument 2 Force requires the lt Speed gt and lt Length gt arguments Speed The Speed string When Mode is 1 or 2 the Speed argument is required When Mode is 0 the lt Speed gt argument is ignored The speed of the PHY port Some valid string values include 100Mb 1Gb and 10Gb The PortAttributes command lists all the valid speeds in Auto negotiate and Force modes Length The length of the direct attach copper cable in meters Valid values are 0 10 A lt Length gt value is required when using a 10Gb SFP Plus transceiver When Mode is 2 the Length argument is required When Mode is 0 or 1 the Length argument is ignored Examples The following example configures the PHY port to a forced speed of 1 Gb sec with a cable length of two meters hbacmd setphyportspeed 00 00 c9 ad ad ac 2 1Gb 2 The following example tries to configure the PHY port to a forced speed of 100 Mb sec hbacmd setphyportspeed 00 00 c9 a9 41 88 2 100Mb This command results in an error because you must include a Length value when Mode is 2 ERROR 431 Cable length required for force mode and interface type OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 56 gt lt EMULEX Authentication Commands SetPortEnab
78. etPfcThrottle argetMapping Persistent Binding Commands AllNodeInfo BindingCapabilities BindingSupport PersistentBinding RemoveAllPersistentBinding RemovePersistentBinding SetBindingSupport SetPersistentBinding Personality Management Commands ShowPersonalities ChangePersonality Universal Multichannel Commands UmcEnable UmcGetParams UmcSetBw UmcSetLPVID Virtual Port VPort Commands CreateVPort DeleteVPort ListVFunctions ListVPorts VPortTargets ListVMs WWN Management Commands ChangeWWN GetWWNCap ReadWWN RestoreWWN Example 2 This help command example shows the details for the SetDCBParam command hbacmd help setdcbparam The example output SetDCBParam lt WWPN MAC gt lt Param gt lt Value gt WWPN World Wide Port Name of FCoE Port MAC MAC address of iSCSI or NIC port Param Parameter Name Value Parameter Value Note 1 For FCoEPriority and iScsiPriority the valid range is 0 to 7 A single priority must be specified 2 For the following parameters the valid values are 0 and 1 DcbxState DcbxMode TxState RxState TxPortDesc TxSysDesc TxSysName TxSysCap ExportSANInfo GetCimCred GetElxSecInfo GetQoSInfo GetVPD ListHBAs OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A Adapter License Management Commands DE EMULEX 5 CLI Client Command Descriptions 51 PfcEnable PfoPriority 3 PfoPriority comma sep
79. eters WWPN The WWPN of the adapter Type X86 OpenBoot or UEFI SetBootParam This command changes the boot parameters You can change adapter parameters and boot device parameters for x86 OpenBoot and UEFI boot e When changing adapter parameters omit the BootDev keyword and value otherwise an error is reported e When changing boot device 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 Supported By Linux Solaris VMware ESX and Windows Syntax SetBootParam WWPN Type Param Valuel BootDev lt Value2 gt Parameters WWPN The WWPN of the adapter Type Possible values are X86 OpenBoot or UEFI Param The parameter name Valuel The parameter value BootDev The boot device OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 62 2c EMULEX CEE Commands Value2 The boot device entry number 0 7 CEE Commands Three CEE commands are listed when you run the help command however the commands are only applicable for a discontinued product and should be ignored Channel Management Commands These commands enable and disable channel management of CNA adapters and the setting of channel properties Each adapter s physical port can be partitioned into a maximum of four isolated channels providing
80. f the UCNA MAC The MAC address of the NIC or iSCSI port Personality Type The available values are nic iscsi and fcoe Example For non ESXi hosts hbacmd ChangePersonality 00 12 34 56 78 9A fcoe For ESXi hosts hbacmd h IP Adress m cim u root p lt password gt n lt namespace gt ChangePersonality 00 12 34 56 78 9A fcoe OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 120 gt lt EMULEX UMC Commands ShowPersonalities This command displays the list of personalities available on the adapter The personality type is displayed as either NIC iSCSI or FCoE Supported By Linux Solaris VMware ESX and Windows Syntax ShowPersonalities lt WWPN MAC gt Parameters WWPN The WWPN of the UCNA MAC The MAC address of the NIC or iSCSI port Example For non ESXi hosts hbacmd ShowPersonalities 00 12 34 56 78 9A For ESXi hosts hbacmd h IP Address m cim u root p password n lt namespace gt showpersonalities 00 12 34 56 78 9A UMC Commands The adapter s physical ports provide a converged conduit for network and storage traffic Each channel has its own unique MAC address Each channel provides traffic management capabilities such as enabling and disabling minium and maximum transmit rates and VLAN ID for untagged packets For additional information on UMC refer to the Emulex Universal Multichannel Reference Guide The
81. 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 lt Auth gt to a value other than 0 you must set additional parameters Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser e If you set the authentication method to One Way CHAP lt Auth gt 1 you must also specify the Target CHAP Name and Target Secret For example hbacmd SetTargetLoginProperties 00 11 22 33 44 55 iscsitarget Auth 1 TgtCHAPName TargetSecret1 e If you set the authentication method to Mutual CHAP lt Auth gt 2 you must specify all four values For example hbacmd SetTargetLoginProperties 00 11 22 33 44 55 iscsitarget Auth 2 TgtChapName TargetSecreti InitCHAPName InitialSecretl Supported By Linux Solaris VMware ESX and Windows Syntax SetTargetLoginProperties lt MAC Address gt lt iscsi target name gt ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 01 1 gt Auth lt 0 1 2 gt TgtCHAPName TgtSecret InitCHAPName InitSecret OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 99 2c EMULEX iSCSI Commands Pa
82. he format blank shows the data in xml format default GetCimCred This command shows the default credentials set for the CIM client Note The password is encrypted Supported By Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX S CLI Client Command Descriptions 110 Miscellaneous Commands Syntax GetCimCred Parameters None GetElxSeclnfo This command shows the version of the ElxSec system Supported By Windows and Linux Syntax GetElxSeclnfo Parameters None GetQoSInfo This command shows the QoS information for a specified NIC port Supported By Linux Solaris VMware ESX and Windows Syntax GetQoSInfo lt MAC Address gt Parameters h The IP address of name of the host WWPN The WWPN of the adapter port MAC The 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 This command shows the port s VPD Supported By Linux Solaris VMware ESX and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 111 Miscellaneous Commands Syntax GetVPD lt WWPN MAC gt Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port ListHBAs This command shows a list of the man
83. he iSCSI target name lt iscsi_target_name gt and either the TSIH lt TSIH gt of the session or the session s ISID Qualifier ISID Qual and the targe s IP address lt Target_IP gt Supported By Linux Solaris VMware ESX and Windows Syntax TargetLogout MAC Address lt iscsi target name TSIH ISID Qual Target 1P gt gt Parameters MAC Address The MAC address of the UCNA port iscsi target name The targe s iSCSI name enclosed in quotes string length 11 255 TSIH The TSIH value of the session The possible values are 1 65535 ISID Qual The ISID qualifier of the session The possible values are 0 65535 Target IP The target s IP address UpdateiSNSServer This command updates the configured iSNS server This command requires the server IP Server IP and port number Port of the iSNS server to be available to respond to the iSNS requests Supported By Linux Solaris VMware ESX and Windows Syntax UpdateiSNSServer MAC Address Server IP Port Parameters MAC Address The MAC address of the UCNA port Server IP IP address of the iSNS server to configure Port Port number of the iSNS server to configure value 1024 65535 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 1Q5 DG EMULEX LUN Masking Commands LUN Masking Commands Notes e Supported for FC FCoE ports only e Linux does not support the Ge
84. hecks if the test must be halted on error 0 No halt 1 Halt on error Hexadecimal data pattern to transmit up to 8 characters This command shows the current beacon state either on or off Supported By Linux Solaris VMware ESX and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 71 Diagnostic Commands 2G EMULEX Syntax GetBeacon lt WWPN MAC gt Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port GetXcvrData Note GetXcvrData is not supported for OneConnect OCe11100 series adapters This command shows transceiver data such as vendor name and serial number Supported By Linux Solaris VMware ESX and Windows Syntax GetXcvrData lt WWPN MAC gt Type Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port Type The type of SFP data to display e 1 Formatted data e 2 Raw data 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 This command shows the flash memory load list data for the adapter Supported By Linux Solaris VMware ESX and Windows Syntax LoadList lt WWPN gt OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CL
85. hs for channel 0 minimum and maximum bandwidths for channel 1 minimum and maximum bandwidths for channel 2 minimum and maximum bandwidths for channel 3 gt hbacmd UmcSetBW 00 00 c9 bb cc aa 25 50 0 50 50 75 25 100 Considerations e This command is not supported on 1 Gb ports e When only three channels are available specifying Min3 Max3 will cause an error e If UMC is disabled when this command is executed a warning message will be displayed indicating that UMC is currently disabled and must be enabled for these changes to take effect UmcSetLPVID This command sets the LPVID for each channel on a physical port A reboot is not required to make these changes take effect when UMC is enabled Supported By Linux Solaris VMware ESX and Windows Syntax UmcSetLPVID lt WWPN MAC Address lt LPVIDO gt LPVID1 LPVID2 LPVID3 Parameters WWPN MAC Address LPVIDO LPVID1 WWPN of the FCoE function on the physical port MAC address of any NIC function on the adapter port LPVID for channel 0 LPVID for channel 1 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 124 2G EMULEX UMC Commands LPVID2 LPVID for channel 2 LPVID3 LPVID for channel 3 Considerations for Using UmcSetLPVID LPVID values are in the range of 2 4094 Every NIC channel on a physical port must have a unique LPVID For FCoE and iSCSI channels 0 must be e
86. i e Deodavas e s dy vs Pe couv dao E Eas k o on 101 ShowWiSNSSerVel 244 cotes ede Ru EVE PE RENT M REPORTE MEE VIRPI oa 101 SliowRouteTable 5 issee edu oi EE nosn vn VPE va v bias valere vonka 101 ShowTarget PTT TT lon DOTT TOTO 102 Shaw largetPortal 252 uepec us uk HEURE RUE EI vaha DEN door on TQUE EE FERE d 102 IET dem 102 IELESdedeE uE 104 UpdateiSNSSerVel a cues e epa pr IER PIRE di IRE a r o v in iu 104 LUN Masking Commands cceeeeeeeeeeeeeeeee ooo ooo ooo ooo oo ooo 105 GOLEUNLISE sa uonra resene zah P r a ees 105 GetLunUnMaskBYHBA cisci osea p eR ER sh kto nr r nr ko ne d dad 105 GetLunUnMaskBy Taf get socne us eese vea o roba va on r vk RR Vinn 106 Rescarbulis 22 s Codes hn E I DSi UP v E TA nov 106 S i2 dsae adhi usur iet TEE ial adu EEEE EE ENERE E UR dis bed o ad dtu du afa 106 Miscellaneous Commiaruds 22 xxx RE anna ni o k oh kn kan RR E 107 Xalal aom cctewa tous arise sien tie oso o oa no novo 107 ChACIGANEVENTLOS zadas iri ti s k n nn b br hon 107 utei nnns 108 DOWHIBS voe seiu o pend dno nn o 108 ExportsABNIBIO aa eidem kun dame treten bb edu ub bl x vPsNA DEM oo n 109 GetCiMCrEd PR 109 GELEBSECIN O ETE PORTER TEMPE TRIES 110 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2c EMU
87. iSCsl This command outputs iSCSI target information in XML format The output can be redirected to a specified file Supported By Linux Solaris and Windows Syntax ExportiSCSI Example In this example the command exports all the iSCSI targets of all the adapters on the host The output is re directed to the file targets xml hbacmd exportiscsi targets xml GetlnitiatorProperties This command shows all the initiator login options for the specified port 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 Supported By Linux Solaris VMware ESX and Windows Syntax GetInitiatorProperties MAC Address Parameters MAC Address The MAC address of the UCNA port GetiSCSiLuns This command shows all the LUNs and their information for a specified target The command gathers the information from the iSCSI target indicated by the lt iscsi_target_name gt parameter Supported By Linux Solaris VMware ESX and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 92 2 EMULEX iSCSI Commands Syntax GetiSCSILuns MAC Address lt iscsi target name gt Parameters MAC Address The MAC address of the UCNA port iscsi target name Targets iSCSI name enclosed in quotes string length 11 255 GetiSCSIPor
88. ide 3 5 wsccccovencecceadecas ence into v tein E rds inei exte eie enge n Hone RD 38 Commands Supported in Target Mode Ports ees seoe esses ene aoa o rape E paa ars 38 Unsupported Commands per Operating System cceeeeeeee eee eene enne 39 Bnet o wv eG MEd ow ae meee eae eee meres sv eewedaue sees 39 RHEL SLES and Oracle rere et Rr y rear on ov 39 adipe m 40 So CIN RETE eck scene one eh daa wae ed E newt UEM 40 builder ossseusiiuad said besseres redne ra ne E EE S EEE TE EERS 41 le c 42 5 CLI Client Command DescriptionS sssossssossssesossessoosesesocssesssossssoooe 43 lll its t a U S 48 Adapter License Management COMMANGAS cccecccscccccccccccccescccessccecssceesees 51 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2c EMULEX Table of Contents 5 InstallAdapterLicense c cece cece eee eeeeeeeeensnsaeeeeeeeeeeeseessssseeeeeeeeeeeeeees 51 ShowAdapterLicenseFeatures cccceeeeeee ee eee eee eeeeeeesseeeeeeeeeeeeeeeeesssugeees 52 ShowAdapterLicenselD cece cece eee ccseeeeeeeeeeeeeeeeeeesseneeeeeseeeeeeeeeesgugaeees 52 Al rib ules Commands ciencia d ha rival ri M vh v PEE MEE 53 HbaAttribUtes eese ae ete Re Sag eu tales aaa YA ead sa e Sore Va VA E UV en ees n vs ees 53 PortAttriDULGS i eise ee eexe ni ipee g re Ne resa used
89. ifier of the session value 0 65535 Target_IP The Target s IP address ImportiSCSI This command imports iSCSI targets from a file to the iSCSI ports on the host Supported By Linux Solaris and Windows Syntax ImportiSCSI lt Import File gt clean Parameters Import File The name of XML file containing import information that was generated by the ExportiSCSI command see ExportiSCSI on page 91 clean Erases entire iSCSI configuration on all iSCSI ports before importing targets Note This command fails if the system is booted from an iSCSI target Example In this example the command imports the iSCSI targets found in the targets xml file to the iSCSI ports found on the host and erases the iSCSI configuration including targets of all iSCSI ports on these host before importing the targets hbacmd importiscsi targets xml clean The example output All existing targets have been removed Added target iqn 2006 01 com openfiler target121 000 0n port 00 00 c9 be 1a 24 Added target iqn 2006 01 com openfiler target121 001 0n port 00 00 c9 be 1a 24 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 94 2c EMULEX iSCSI Commands Added target iqn 2006 01 com openfiler target122 000 on port 00 00 c9 2f 45 1b Added target iqn 2006 01 com openfiler target122 001 on port 00 00 c9 2f 45 1b iSCSIPing This command issues ICMP echo requests to a target
90. ill allow command usage as appropriate OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2 Installing and Uninstalling the CLI 17 2 EMULEX na 2 Installing and Uninstalling the CLI This chapter details prerequisites and procedures for installing and uninstalling the OneCommand Manager CLI in the following operating systems Linux Solaris VMware ESX ESXi and Windows It also describes the Secure Management capability and the procedure for starting and stopping daemon processes Linux Citrix Citrix is based on CentOS Linux however for the OneCommand Manager CLI Citrix is more comparable to VMware a hypervisor style server for managing virtual machines The Citrix XenServer 6 1 operating system contains the OneCommand Manager CLI application and no additional installation is required Citrix XenServer 5 6 SP2 and Citrix XenServer 6 0 operating systems will require OCM CLI installation if it is needed Note Updated versions of OneCommand Manager CLI for Citrix XenServer are available as part of the Device Update Driver kit for Citrix XenServer 5 6 SP2 and Citrix XenServer 6 0 For the latest kit see the Emulex website Installing in Linux Without an Existing OneCommand CLI Kit Note Prior to installation OneCommand groups must be configured on the LDAP network or the local host machine for Secure Management operation See OCM Secure Management Configuration Requirements on
91. in the OneCommand Manager application will authenticate the user with those defined in that domain For Linux and Solaris systems this is done using PAM Note OneCommand Manager Secure Management is supported on Linux Solaris and Windows but is not supported on VMware hosts Administrators set up user accounts such that a user belongs to one of the OneCommand Manager application user groups The user groups define the management capabilities for the user The following table defines the OneCommand Manager application user groups and each group s management capabilities Table 1 1 Secure Management User Privileges Group Name OneCommand Manager Capability ocmadmin Allows full active management of local and remote adapters ocmlocaladmin Permits full active management of local adapters only ocmuser Permits read only access of local and remote adapters ocmlocaluser Permits read only access of local adapters On Linux or Solaris systems the unix getent group utility can be run on the target host system s command shell to verify the correct configuration of the groups The groups and users within the groups will appear in the output of this command Note Although a user may belong to the administrator group or be the root user they will not have full privileges to run OneCommand Manager unless they are also a member of the ocmadmin group Otherwise when secure management is enabled a root user or administrator can
92. iptions 118 Persistent Binding Commands WWPN The WWPN of the adapter BindFlag The type of binding support for the adapter D Binding by D ID not available for Storport Miniport driver P Binding by WWPN N Binding by WWNN not available for Storport Miniport driver A Binding by automap not available for Storport Miniport driver DA Binding by D ID and automap PA Binding by WWPN and automap NA Binding by WWNN and automap SetPersistentBinding 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 Supported By Solaris and Windows Syntax SetPersistentBinding WWPN Scope lt BindType gt lt TargetId gt lt SCSIBus gt lt SCSITarget gt Parameters WWPN Scope BindType Targetid SCSIBus SCSITarget The WWPN of the adapter P Permanent binding survives reboot I Immediate binding B Binding is both permanent and immediate P Enable binding by WWPN N Enable binding by WWNN D Enable binding by D_ID If BindType P Target WWPN If BindType N Target WWNN If BindType D Target D ID The bus number of the SCSI device The target number of the SCSI device OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 5 CLI Client Command Descriptions 119 Personality Change Commands Personality Change Commands The OneCommand Manage
93. is command shows the properties for a specified SendTarget Portal If the lt Target_IP gt and lt Port gt are not specified all SendTarget Portals and their associated properties return Supported By Linux Solaris and Windows Syntax ShowTargetPortal MAC Address Target IP lt Port gt Parameters MAC Address The MAC address of the UCNA port Target IP IP address of the target portal Port Port number of the target portal TargetLogin This command logs in to a target The iSCSI target name lt iscsi target name is the only mandatory option The target portal and port information are optional and OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 103 2c EMULEX iSCSI Commands 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 Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser e If you set the authentication method to One Way CHAP lt Auth gt 1 you must also specify the Target CHAP Name and Target Secret For example hbacmd TargetLogin 00 11 22 33 44 55 iscsitarget Auth 1 TgtChapName TargetSecretl e If you set the authentication
94. is disabled 0 Disabled 1 Enabled Receive State DCBX uses 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 0 Disabled 1 Enabled Transmit Port Description provides a description of the port in an alpha numeric format 0 Disabled 1 Enabled Transmit System Description provides a description of the network entity in an alpha numeric format 0 Disabled 1 Enabled Transmit System Name provides the system s assigned name in an alpha numeric format 0 Disabled 1 Enabled Transmit System Capabilities 0 Disabled 1 Enabled 192 203 151 m cim u root p Swamiji001 n root emulex setdcbparam 00 00 09 30 f7 88 fcoepriority 3 SetDCBPriority This command sets the priorities for a priority group The values must be set according to the following rules 1 The priorities range from 0 to 7 2 The PGIDs range from 0 to 7 3 A priority can exist in only one priority group 4 All priorities must appear once in any of the eight priority groups PGO PG7 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions gt lt EMULEX DCB Commands 69 5 Each set of priorities for a group must be separated by a space 6 Specify multiple priorities for the same group by a comma separated list 7 To specify
95. it version directory cd elxocm solaris kit version gt 4 Runthe install script and follow the instructions install OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 3 Updating to the OneCommand Manager Application Enterprise Kit 29 2G EMULEX Windows Windows To update from the OneCommand Manager CLI to the full featured OneCommand Manager application enterprise kit in Windows 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 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2C EMULEX 4 CLI Client Command Usage 30 Overview 4 CLI Client Command Usage Overview The CLI Client component of the OneCommand Manager application provides access to the capabilities of the Remote Management library or the CIM interface from a console command prompt to get the management information The CLI Client is intended for use in scripted operations from within shell scripts or batch files The CLI Client is a console application named HbaCmd A single operation is performed by entering hbacmd followed by a CLI client command and its possible parameters at the command line For example hbacmd command paramete
96. l panel e Through the command line Uninstalling through the Control Panel To uninstall the OneCommand Manager CLI in Windows through the control panel 1 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 Uninstalling through the Command Line To uninstall the OneCommand Manager CLI in Windows through the command line 1 Change to the appropriate uninstall directory cd Install Location gt Emulex Util Uninstall 2 Type uninstall OCManager Core bat OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 2 Installing and Uninstalling the CLI 27 DG EMULEX Starting and Stopping Daemon Processes Starting and Stopping Daemon Processes Linux and Solaris 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 directories e Linux usr sbin ocmanager e Solaris opt ELXocm There are two basic daemon processes included with OneCommand Manager CLI that are affected by these scripts They are e elxh
97. led This command enables or disables the FC or UCNA port Notes e Ensure that all I Os on the port are stopped before disabling the port Only OneConnect adapters do not require a reset when the adapter port is enabled or disabled For all other adapters when the SetPortEnabled command disables an FC port the adapter must be reset to activate the new setting Supported By Linux Solaris VMware ESX and Windows Syntax SetPortEnabled WWPN MAC lt PortEnable gt Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port PortEnabled The port enabled state 0 Disabled 1 Enabled Authentication Commands Note Authentication commands are supported on FC adapter ports only These commands are not available on LP1600x adapters AuthConfigList This command returns the list of WWPNs that have an authentication connection configuration with the specified adapter Supported By Linux Solaris and Windows Syntax AuthConfigList lt WWPN gt Parameters WWPN The WWPN of the adapter OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 57 Authentication Commands DeleteAuthConfig This command deletes the authentication configuration on the adapter Supported By Linux Solaris and Windows Syntax DeleteAuthConfig WWPN1 lt WWPN2 gt PasswordType Password Parame
98. ll manageable ports OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions gt lt EMULEX VPort Commands 147 If you specify the host with the h lt host gt option or provide the physical WWPN only the virtual machines for that host are returned If you specify the physical port and the virtual port only the virtual machine for the specified virtual port are returned The virtual machine name is only displayed if the virtual port is associated with a virtual machine on VMware ESX 4 1 If you are running this command on any other server that has virtual ports you will not see the virtual machine name Supported By Linux and VMware FSX Syntax ListVMs lt physical WWPN gt lt virtual WWPN gt Parameters physical WWPN The WWPN of the adapter virtual WWPN The WWPN of the virtual port ListVPorts 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 Supported By Linux Solaris VMware ESX and Windows Syntax ListVPorts lt physical WWPN gt Parameters physical WWPN The WWPN of the adapter VPortTargets This command lists targets visible to the specified virtual port Supported By Linux Solaris VMware ESX and Windows Syntax VPortTargets lt physical WWPN gt lt virtual WWPN gt OneCommand Manager Com
99. lowing command hbacmd lt h 192 168 1 122 gt m sec u jsmith p lt joepassword gt download 00 12 34 56 78 9A ocll1 4 6 96 2 ufi CIM Interface Notes e In Linux and Solaris you cannot use hbacmd as a CIM client e The OneCommand Manager CLI running on the VMware ESX 4 1 COS does not support the management of adapters using the CIM interface OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 4 CLI Client Command Usage 33 2 EMULEX CIM Interface Device Management Using the CIM Interface VMware on the hypervisor based ESXi platforms use the CIM as the only standard management mechanism for device management For VMware ESXi 4 1 VMware ESXi 5 0 and VMware ESXi 5 1 hosts you can manage adapters using the OneCommand Manager on Windows but you must install and use the appropriate Emulex CIM Provider For installation see Installing the CIM Provider for VMware ESXi Hosts on page 23 Note For VMware ESXi 5 0 and 5 1 hosts when advanced adapter management capabilities are required for example iSCSI Management and port disable use the OneCommand Manager for VMware vCenter software plug in For more details see the OneCommand Manager for VMware vCenter User Manual Syntax Rules for the CIM Interface For the CIM interface all the syntax rules in section HbaCmd Syntax Usage on page 30 apply except that the h option is required Additionally the m cim parameter is
100. lp command lists all the commands in their respective groups Using the optional parameter GroupName it lists the commands in a group Using the optional parameter CmdName it shows the details for a specific command Supported By Linux Solaris VMware ESX and Windows Syntax Help GroupName CmdName Parameters GroupName This optional parameter lists the commands in a particular group CmdName This optional parameter shows the details for a particular CLI command Example 1 This help command example lists all the commands in their respective groups hbacmd help The example output Usage hbacmd version or hbacmd h IPv4 Address port Hostname port Command or hbacmd h IPv6 Address port lt Command gt Note When specifying IPv6 address with port option it must be enclosed in Example fe80 6445 80e9 9878 a527 9876 Use the following syntax for issuing CIM based commands IPv4 only A gt hbacmd lt h IPv4 port gt lt m CIM gt u userid p password n namespace lt cmd gt B gt hbacmd lt h IPv4 port gt lt m CIM gt lt cmd gt Before specifying syntax B the user should do one of the following 1 Add the host IP with CIM credentials using the AddHost command e g hbacmd lt m CIM gt u userid p password n namespace AddHost lt ip gt 2 Set the default CIM credentials using the SetCimCred command e g hbacmd SetCimCred lt u userid gt lt p password gt lt n
101. lumn shows the protocol that is running on each channel Note For some adapters three channels will be shown instead of four because the physical port will only support three Supported By Linux Solaris VMware and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 63 Channel Management Commands 2G EMULEX Syntax hbacmd CMGetParams lt WWPN MAC Address gt Parameters WWPN WWPN of an FCoE function on the physical port Type MAC address of any NIC function on the physical adapter port Example gt hbacmd CMGetParams 00 00 c9 12 34 56 Active state Disabled Configured mode None Available modes vNIC1 vNIC2 UFP gt hbacmd CMGetParams 00 00 c9 12 34 56 Active state Enabled Configured mode UMC Available modes vNIC1 vNIC2 UFP Func Type MAC Address LPVID Min BW Max BW 0 NIC 00 00 c9 bb cc aa 2 25 50 1 NIC 00 00 c9 bb cc ab 3 0 50 2 NIC 00 00 c9 bb cc ac 4 229 50 3 NIC 00 00 c9 bb cc ad 5 50 75 CMMode This command enables a channel management mode or disables channel management For UMC configurations the UMCEnable command can still be used to enable UMC only This command sets the channel management type at the adapter level A system reboot is required to make the change take effect Supported By Linux Solaris VMware ESX and Windows Syntax hbacmd CMMode WWPN MAC Address None Type Parameters
102. mand Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 74 Diagnostic Commands 2G EMULEX Header Type 0x80 Built In Self Test 0x00 Base Address 0 0x00000000 Base Address 1 OxDF478000 Base Address 2 OxDF480004 Base Address 3 0x00000000 Base Address 4 OxDF4A0004 Base Address 5 0x00000000 CIS 0x00000000 SubVendor ID 0x10DF SubSystem 1D 0xm 622 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 This command runs the POST on the adapter Support for a remote adapter is through TCP IP access only Supported By Linux Solaris VMware ESX and Windows Syntax PostTest lt WWPN gt Parameters WWPN The WWPN of the adapter SetBeacon This command turns the beacon on or off Supported By Linux Solaris VMware ESX and Windows Syntax SetBeacon WWPN MAC lt BeaconState gt Parameters WWPN The WWPN of the FC port MAC The MAC address of the NIC or iSCSI port BeaconState Indicates the state of the beacon to be set to 0 Off 1 On OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 75 Diagnostic Commands SetCableNVP Note This command supports only OneConnect OCe11100 series adapters This command sets the NVP required for the TDRTest comm
103. mand Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 5 CLI Client Command Descriptions 128 WWN Management Commands Parameters physical WWPN The WWPN of the adapter virtual WWPN The WWPN of the virtual port WWN Management Commands Notes Supported for FC FCoE adapter ports only 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 This command changes the volatile state of WWNs If the volatile change is requested onana Notes dapter that does not support volatile WWNS it returns a not supported error 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 For VMware ESX o After changing the WWN of an adapter update your zoning settings before you reboot your ESX server If the zoning is not updated before your reboot the subsequent boot may take a long time o 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 the VMware documentation For ESX COS
104. mand shows the maximum number of diagnostic dump files to keep Supported By Linux Solaris VMware ESX and Windows Syntax GetRetentionCount WWPN MAC Parameters WWPN The WWPN of the adapter MAC The MAC address of the UCNA port SetDumpDirectory This command sets the dump directory for the VMware ESX ESXi hosts only Supported By VMware ESX To use the SetDumpDirectory command you must have a directory which must be a Storage partition 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 The application checks for the dump directory and creates the dump files in that location OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 83 DG EMULEX Dump Commands Notes e The dump directory applies to all adapters in the server There is no separate dump directory for each adapter e Ina remote environment you can use the SetDumpDirectory command from a host running any operating system including Linux Solaris and Windows but only to a remote host that is running VMware ESX ESXi Syntax For VMware ESX using the RM interface hbacmd h IP Aaddress port setdumpdirectory lt DumpDirectoryName gt For VMware ESX ESXi using the CIM interface hbacmd h IP Address m cim u lt usernam
105. method to Mutual CHAP lt Auth gt 2 you must specify all four values For example hbacmd TargetLogin 00 11 22 33 44 55 iscsitarget Auth 2 TgtChapName TargetSecretl InitCHAPName InitialSecret1 Supported By Linux Solaris VMware ESX and Windows Syntax TargetLogin MAC Address lt iscsi target name 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 InitCHAPName InitSecret Parameters MAC Address The MAC address of the UCNA port iscsi target name The target s iSCSI name enclosed in quotes string length 11 255 Port The port number of the target portal The possible values are 1024 65535 ImmediateData 0 2 No 1 Yes default HeaderDigest 0 None default 1 CRC32C DataDigest 0 None default 1 CRC32C Auth 0 None default 1 One Way CHAP 2 Mutual CHAP TgtCHAPNam The Target CHAP name enclosed in quotes string length 1 255 TgtSecret The Target Secret enclosed in quotes string length 12 16 InitCHAPName The Initiator CHAP name enclosed in quotes string length 1 255 InitSecret The Initiator Secret enclosed in quotes string length 12 16 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 104 2 EMULEX iSCSI Commands TargetLogout This command logs out of a target You must specify t
106. mmand Manager Command Line Interface Version 6 3 User Manual 4 CLI Client Command Usage 40 Unsupported Commands per Operating System P009403 01A Rev A 2G EMULEX CnaClearEventLog CnaGetEventLog DriverConfig GetCimCred GetElxSeclnfo ListVMs SetCimCred SetDumpDirectory VMWare ESX VMWare ESX does not support the following CLI commands AuthConfig List BindingCapabilities BindingSupport CreateVPort DeleteAuthConfig DeleteVPort GetAuthConfig GetAuthStatus GetCimCred GetElxSecInfo GetLunList GetLunUnMaskByHBA GetLunUnMaskBy Target GetProtocollnfo ImportSCSI InitiateAuth PersistentBinding RemoveAllPersistentBinding RemovePersistentBinding RescanLuns SetAuthConfig SetBindingSupport SetCimCred SetLunMask SetPersistentBinding SetPassword SetPortProtocol OneCommand Manager Command Line Interface Version 6 3 User Manual 4 CLI Client Command Usage 41 Unsupported Commands per Operating System P009403 01A Rev A 4 CLI Client Command Usage 42 DG EMULEX Unsupported Commands per Operating System Windows Windows does not support the following CLI commands e SetDumpDirectory e ListVMs OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 43 5 CLI Client Command Descriptions A check mark v designates a supported command for a particular operating system CIM interface and some CIM provider versions Table 5 1 CLI
107. nd For VMware ESX ESXi using the CIM interface hbacmd m cim u lt username gt p lt password gt n lt namespace gt addhost lt IP_Address gt If the username password and namespace are not specified see Default CIM Credentials on page 34 Parameters host address The IP address using the IPv4 or IPv6 format or the host name IP Address The IP address of the host CnaClearEventLog Note Supported for OneConnect adapters only OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions 2 EMULEX Miscellaneous Commands ie This command clears the UCNA event log specified by the WWPN or MAC address Supported By Linux VMware ESX and Windows Syntax CnaClearEventLog lt WWPN MAC gt Parameters WWPN The WWPN of the UCNA FCoE port MAC The MAC address of the NIC or iSCSI port of the UCNA CnaGetEventLog Note Supported for OneConnect adapters only This command shows the UCNA event log specified by the WWPN or MAC address Supported By Linux VMware ESX and Windows Syntax CnaGetEventLog lt WWPN MAC gt Parameters WWPN The WWPN of the adapter port MAC The MAC address of the NIC or iSCSI port Download Loads the firmware image to the FC or UCNA port specified by the WWPN or MAC address Notes e For 16 Gb HBA firmware downloads OneCommand Manager only accepts grp files e For OneConnect and 16 Gb HBAs while the
108. nd Manager CLl uiis osus dE avo uva UV OREREPN CR r i vndas Saad ud 22 Uninstalling in a VMware ESX Server eeeeeseeeeeeeee eene ene enhn nnne 23 Uninstalling an Older HBAnyware or a OneCommand Manager Kit in a VMware ESX Server cocer see ee eere Ere pun eaa S uv epe pee rese no nl 23 Installing the CIM Provider for VMware ESXi Hosts cessere enn 23 WINDOWS c 24 Installing in WIBOOWS ueris ka ee oCep avo Ra bosia EP v E ERN WEE E NEUE 24 Attended Installation dore ebat rete praet raa Don ied vee au oaa exo sa es ku vec eu DV EE vw ve 24 Unattended Installations essiri eere eee eee rrr v 24 Uninstalling in W IndOWSeseas sse ok UE ae DAE dE S PIRE E EIC REP RAND o Md 26 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 3 2c EMULEX Table of Contents 4 Uninstalling through the Control Panel c cee cceeee cece ee ee eee on o nn eneeeeseeeeeeeees 26 Uninstalling through the Command Line cece eecceeeeeeeeeceeeeeeeeeeeeeeseeeeneaes 26 Starting and Stopping Daemon Processes csssccccccscccccsscsccccccsscccesssscceecsees 27 LINUX and Solaris serere he n s rp eae ee T p RAT EE e ER EET EE EE E VT e ug 27 VMware ESX Server reser ere a y ae n res x ee sind vegas SEE ERE Va FESTER E E ENTFERNT ces 27 3 Updating to the OneCommand Manager Application Enterprise Kit 28 Ej
109. ntered since LPVIDs cannot be set for storage channels When only three channels are available specifying LPVID3 will cause an error This command is not supported on 1 Gb ports If UMC is disabled when this command is executed a warning message will be displayed indicating that UMC is currently disabled and must be enabled for these changes to take effect Examples All NIC gt hbacmd UmcSetLPVID 00 00 c9 bb cc aa 1001 1002 1003 1004 NIC Plus Storage gt hbacmd UmcSetLPVID 00 00 c9 bb cc aa 1001 0 1002 1003 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions DG EMULEX VPort Commands 123 VPort Commands Note Supported by FC and FCoE adapter ports only 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 vname optional parameter can be specified for the virtual por s name Note In Linux VPorts do not persist across system reboots CreateVPort Supported By Linux Solaris and Windows Syntax CreateVPort lt physical WWPN gt auto vname 01 CreateVPort lt physical WWPN gt lt virtual WWPN gt lt virtual WWNN gt vname P
110. oot T Make change temporary 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 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 text files txt extension and binary files The extension for binary files depends on the adapter type e OneConnect UCNAs Enhanced FAT Dump edf extension e OneConnect UCNAs Core Dump core extension e 16 Gb HBAs bin extension e Legacy and LightPulse adapters dmp extension DeleteDumpFiles This command deletes all diagnostic dump files for the adapter Supported By Linux Solaris VMware ESX and Windows Syntax DeleteDumpFiles lt WWPN MAC gt OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 80 Dump Commands Parameters WWPN The WWPN of the adapter MAC The MAC address of the UCNA port Dump This command creates a diagnostic dump file in the HbaCmd dump file directory Note In some cases a core dump can be performed on an inoperative OneConnect UCNA To view inoperable UCNAs on the local host use the List HBAs down command See ListHBAs on page 111
111. otFromSan parameter is also enabled Supported By Linux Solaris VMware ESX and Windows Syntax EnableBootCode lt W Parameters WWPN NIC MAC Flag NetworkBootMethod Examples The following examp C Program Files WPN NIC MAC gt lt Flag gt lt NetworkBootMethod gt World Wide Port Name of FC port MAC address of the NIC port D Disable the boot code E Enable the boot code Network boot method to be used by the NIC PXE or iBFT The network boot types supported on the specific NIC may be found in the Available Network Boot Methods string displayed by the HbaAttributes command This parameter is not required for FC or FCoE ports and is only specified when enabling network boot le enables iBFT for a NIC Emulex Util OCManager gt HBACMD EnableNetworkBoot 00 00 c9 11 22 33 e iBFT OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 5 CLI Client Command Descriptions 61 Boot Commands The following example disables network boot C Program Files Emulex Util OCManager gt HBACMD EnableNetworkBoot 00 00 c9 11 22 33 d GetBootParams 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 Supported By Linux Solaris VMware ESX and Windows Syntax GetBootParams lt WWPN gt lt Type gt Param
112. paces When using space separators the entire WWPN must be enclosed in quotes For example the following command displays 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 Where a MAC address is specified each pair of numbers within the MAC address is separated by a dash For example the following command sets the target properties for the UCNA port with the specified MAC address with an extended timeout value of 1 hbacmd SetTargetProperties 00 11 22 33 44 55 iscsiTarget 1 For NIC ports only the permanent MAC address is supported for the port address parameter on an HbaCmd command line Normally fora UCNA port the port s permanent MAC address and current MAC address parameters are equal However it is possible to set a user specified current MAC Address that is different from the permanent MAC address Also for some implementations it is possible to have multiple UCNA ports with the same current MAC addresses but with unique permanent MAC addresses Therefore to ensure that the OneCommand Manager can access the correct port only the permanent MAC address is supported Note that both the permanent MAC address and the current MAC address are displayed by using the ListHBAs command See ListHBAs on page 111 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A
113. ple when UMC is enabled priority groups are not available Therefore the SetCNAPGBW and SetDCBPriority commands would not be available e These commands are not available on Ce11101 EM EX or OCe11102 EM EX adapters The following error message will be returned ERROR 222 DCB not available GetDCBParams 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 UCNAs Supported By Linux Solaris VMware ESX and Windows Syntax GetDCBParams lt WWPN MAC gt Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port Example hbacmd h 10 192 203 154 getdcbparams 00 00 c9 93 2f d8 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 66 2 EMULEX DCB Commands GetPGlnfo 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 Supported By Linux Solaris VMware ESX and Windows Syntax GetPGInfo WWPN MAC Parameters WWPN The WWPN address of the FCoE port MAC The MAC address of the NIC or iSCSI port Example hbacmd h 10 192 203 154 getpginfo 00 00 c9 93 2f d8 SetCnaPGBW This command sets the bandwidth percentage of a priority group according to the following rules 1 Bandwidths BW0 BW7 for priority g
114. pported By Linux Solaris VMware ESX and Windows Syntax hbacmd UmcEnable WWPN MAC Address lt 0 1 gt Parameters WWPN WWPN of the FCoE function on the physical port MAC Address MAC address of any NIC function on the adapter port 0 Disable UMC 1 Enable UMC Example gt hbacmd UmcEnable 00 00 c9 bb cc aa 1 UmcGetParams Shows the current UMC configuration for an adapter s physical port The command s output is the current UMC state for the adapter and also a table showing the port s channels along with their UMC properties On some adapters only three channels will be shown instead of four because that is all the physical port supports Also the channel Type property shows the protocol that is running on the channel This is controlled by the CLI s ChangePersonality command not the UMC commands Supported By Linux Solaris VMware ESX and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 122 2c EMULEX UMC Commands Syntax UmcGetParams lt WWPN MAC Address gt Parameters WWPN WWPN of an FCoE function on the physical port MAC Address MAC address of any NIC function on the adapter port Example AII NIC hbacmd UmcGetParams 00 00 c9 bb cc aa Active UMC State Enabled Configured UMC State Enabled Func Type MAC Address LPVID Min BW Max BW 0 NIC 00 00 c9 bb cc aa 2 25 50 I NIC 00 00 c9 bb cc ab 3 0 0
115. r Supported By Linux Solaris and Windows Syntax SetPassword WWPN1 WWPN2 Flag lt Cpt gt lt Cpw gt Npt lt Npw gt Parameters WWPN1 The WWPN of the adapter WWPN2 Must be ff ff ff ff ff ff ff ff for a switch or the actual WWPN for a target Flag 1 Local password used by the adapter when the adapter authenticates to the switch 2 Remote password used by the adapter when the 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 Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 60 Boot Commands Npt New password type 1 ASCII 2 Hex binary Npw New password value Boot Commands EnableBootCode This command is used to perform either of the following e Enable or disable network boot for UCNA NIC ports If network boot is being enabled it is necessary to select the specific network boot type The supported network boot UCNA types types are PXE and iBFT Note that iBFT is not supported on all e Enable disable the boot code for an FC adapter port If the boot code is disabled on the FC ada pter the adapter does not boot from the SAN regardless of the value for the EnableBootFromSan boot parameter If the boot code is enabled on the FC adapter the adapter boots from the SAN if the EnableBo
116. r Command Line Interface Version 6 3 User Manual P009403 01A Rev A 37 2G EMULEX GetDCBParams GetDumpDirectory GetDumpFile GetDumpFileNames GetFCFInfo GetFipParams GetRetentionCount GetPGInfo SetDCBParam SetCnaPgBw SetDCBPriority SetDumpbDirectory SetFIPParam SetRetentionCount CIM Provider 3 2 CIM Provider 3 2 supports the following commands 4 CLI Client Command Usage Commands Supported in Target Mode Ports All the commands listed in the previous section for CIM Provider 3 1 on page 37 ChangePersonality InstallAdapterLicense ShowAdapterLicenseFeatures ShowLicenseAdapterID ShowPersonalities CIM Provider 3 4 4 CIM Provider 3 4 4 supports the following commands All the commands listed in the previous section for CIM Provider 3 2 on page 38 SetCableNVP CIM Provider 3 5 CIM Provider 3 5 supports the following commands All the commands listed in the previous section for CIM Provider 3 4 4 on page 38 SetPhyPortSpeed Commands Supported in Target Mode Ports The following HbaCmd commands are supported for managing target mode ports OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 38 2G EMULEX e CreateVPort e DeleteDumpFiles e DeleteVPort e Download e DriverConfig e ExportSanInfo e GetDriverParams e GetDriverParamsGlobal e GetDumpDirectory e GetDumpFile e GetRetentionCount e GetVPD e GetXcvrData e HbaAttribu
117. r 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 the 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 51 for more information Notes e 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 e It is possible to install one or more driver kits for the current personality then change the personality and no longer have the drivers necessary to run the adapter If you change personalities you must install the appropriate drivers The appropriate drivers are available on the Emulex website e These commands are not available on LP1600x adapters ChangePersonality This command changes the personality on the adapter After successful change a reboot is required Supported By Linux Solaris VMware ESX and Windows Syntax ChangePersonality lt WWPN MAC gt lt personality type gt Parameters WWPN The WWPN o
118. rameters MAC Address The MAC address of the UCNA port iscsi target name Target s iSCSI name enclosed in quotes string length 11 255 ImmediateData 0 No 1 Yes default HeaderDigest 0 None default 1 CRC32C DataDigest 0 None default 1 CRC32C Auth 0 gt None default 1 One Way CHAP 2 Mutual CHAP TgtCHAPNam 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 SetTargetProperties This command sets the ETO value of a target Supported By Linux Solaris VMware ESX and Windows Syntax SetTargetProperties MAC Address lt iscsi target name lt ETO gt Parameters MAC Address The MAC address of the UCNA port iscsi target name Target s iSCSI name enclosed in quotes string length 11 255 ETO The extended timeout option for the target e For Windows valid values are 0 3600 e For Linux Solaris and VMware ESX valid values are 0 30 SetTPLoginProperties This command sets a target porta s login properties This command reguires that you specify a valid Target IP lt Target_IP 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 this command to mak
119. rameters are available to be persistently bound Also the lt BindType gt parameter 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 AllNodelnfo This command shows target node information for each target accessible by the adapter Supported By Linux Solaris VMware ESX and Windows Syntax AllNodeInfo lt WWPN gt Parameters WWPN The WWPN of the adapter BindingCapabilities This command shows the binding capabilities of the adapter If a binding is configured it is maintained across reboots OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX S CLI Client Command Descriptions 116 Persistent Binding Commands Supported By Solaris and Windows Syntax BindingCapabilities lt WWPN gt Parameters WWPN The WWPN of the adapter BindingSupport This command shows the binding support for the adapter Supported By Solaris and Windows Syntax BindingSupport WWPN Source Parameters WWPN The WWPN of the adapter Source C Configuration support L Live support PersistentBinding This command specifies which set of persistent binding information configuration or live state is requested Supported By Solaris and Windows Syntax PersistentBinding WWPN Source Parameters WWPN The WWPN of the adapter Source C Configuration support
120. re ESX and Windows Syntax For the RM interface hbacmd Version Note The h option for specifying an optional IP address or host name after hbacmd is not available for the Version command For VMware ESX ESXi using the CIM interface hbacmd h IP address m cim version Parameters None OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions SE EMULEX Persistent Binding Commands 113 Persistent Binding Commands Notes e These commands are supported for FC FCoE ports only e The following persistent binding commands are not supported on Linux or VMware ESX o BindingCapabilities o BindingSupport o PersistentBinding o RemoveAllPersistentBinding o RemovePersistentBinding o SetPersistentBinding o SetBindingSupport In a remote environment you can perform persistent bindings operations from a host running any operating system including Linux or VMware ESX but only to a remote host that is running Windows or Solaris e Forabinding to take effect immediately that is SetPersistentBinding parameter Scope I or B the lt SCSIBus gt and lt SCSITarget gt parameters 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 lt SCSIBus gt and lt SCSITarget gt pa
121. river version 2 102 440 0 or later must be loaded e To manage iSCSI adapters the iSCSI driver must be loaded To install the OneCommand Manager CLI 1 Login to the VMware ESX server COS 2 Copy the elxocmcore esxNN lt kit version gt lt arch gt rpm file to a directory on the install machine e NN is the VMware ESX version It is 41 for VMware ESX 4 1 e kit version represents the complete version e arch is x86 64 and is applicable to x64 or x86 architectures 3 Change to the directory where you copied the rpm file Install the rpm file by typing rpm Uvh elxocmcore esxNN kit version gt lt arch gt rpm e Seethe VMware ESX version kit version and arch parameter descriptions in step 2 The rpm contents are installed in usr sbin ocmanager The OneCommand Manager CLI is also located in this directory Installing in a VMware ESX Server with an Existing HBAnyware or OneCommand Manager CLI To install the OneCommand Manager CLI 1 Install the rpm file f rpm Uvh elxocmcore esxNN kit version arch rpm e NN is the VMware ESX version It is 41 for VMware ESX 4 1 e kit version represents the complete version e arch is x86 64 and is applicable to x64 or x86 architectures OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 2 Installing and Uninstalling the CLI 23 2G EMULEX VMware ESX ESXi Uninstalling in a VMware ESX Server To unins
122. root emulex loopbacktest 00 00 c9 93 2f 9f 4 120 0 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 5 CLI Client Command Descriptions 73 Diagnostic Commands LoopMap Note Supported for FC ports only This command shows the arbitrated loop map data Supported By Linux Solaris and Windows Syntax LoopMap lt WWPN gt Parameters WWPN The WWPN of the adapter PciData This command shows the 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 UCNA Supported By Linux Solaris VMware ESX and Windows Syntax PciData lt WWPN MAC gt Parameters WWPN The WWPN of the adapter s port MAC The 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 pcidata 00 00 c9 93 2f d6 The example output Vendor ID 0x19A2 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 OneCommand Manager Com
123. roups 0 7 PGO PG7 must total 100 for 100 2 Bandwidth can be assigned to a priority group that has priorities Supported By Linux Solaris VMware ESX and Windows Syntax SetCnaPGBW lt WWPN MAC gt lt BWO BW7 gt Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port BWO BW7 The bandwidths allocated for the priority groups 0 7 Example This command sets the bandwidth of PGO to 50 PG1 to 50 and PG2 PG7 to 0 hbacmd SetCnaPGBW 10 00 00 00 c9 3c f 7 88 5050000000 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 67 DCB Commands SetDCBParam This command configures the DCB and LLDP settings on the OneConnect adapter Supported By Linux Solaris VMware ESX and Windows Syntax SetDCBParam lt WWPN MAC gt lt Param gt lt Value gt Parameters WWPN The WWPN of the adapter MAC The MAC address of the NIC or iSCSI port Param The parameter name See the following DCB Settings for lt Param gt and lt Value gt and LLDP Settings for lt Param gt and lt Value gt sections Value The parameter value See the following DCB Settings for lt Param gt and lt Value gt and LLDP Settings for lt Param gt and lt Value gt sections DCB Settings for lt Param gt and Value lt Param gt DCBXState DCBXMode PFCEnable FCoEPrior iSCSIPrio PFCPriori
124. rs Note To run the HBACMD application when Secure Management is enabled you must include your user name and password each time you type a command For example e Secure Management disabled hbacmd command e Secure Management enabled hbacmd lt m sec gt lt userid gt lt password gt lt command gt User names and passwords are used to authenticate the commands Once the credentials are authenticated the OCM will determine which one of the four user groups you belong to and will allow command usage as appropriate See OneCommand Manager Secure Management on page 13 for more information When the specified operation is completed the command prompt is displayed For a majority of commands the first parameter following the command is the WWPN or MAC address of the port that the command is to act upon CLI in Read Only Mode May Cause Error Message Note The CLI does not allow the execution of certain commands when it is configured for read only mode The following error message is returned 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 HbaCmd Syntax Usage The following syntax rules and usage are applicable for the HbaCmd application e Parameters denoted within angle brackets lt gt are required e Parameters denoted within square brackets are optional OneCommand Manager Command Line Interface Version 6
125. s Syntax AddRouteTableEntry MAC Address lt Dest IP Address lt Subnet Mask gt Gateway Parameters MAC Address MAC address of the UCNA 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 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 lt Target_IP gt port number lt Port gt and iSCSI name lt iscsi_target_name gt 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 Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser e If you set the authentication method to One Way CHAP lt Auth gt 1 you must also specify the Target CHAP Name and Target Secret For example hbacmd AddTarget 00 11 22 33 44 55 192 168 1 1 8000 iscsitarget Auth 1 TgtCHAPName TargetSecretl e If you set the authentication method to Mutual CHAP lt Auth gt 2 you must specify all four values For example hbacmd AddTarget 00 11 22 33 44 55 192 168 1 1 8000 iscsitarget Auth 1 TgtCHAPName TargtSecretl InitCHAPName InitialSecre
126. s WWPN The WWPN of the adapter Example hbacmd getfcfinfo 10 00 00 00 c9 3c 7 88 GetFIPParams This command gets the FIP parameters of the OneConnect adapter in FCoE mode Supported By Linux Solaris VMware ESX and Windows Syntax GetFIPParams lt WWPN gt Parameters WWPN The WWPN of the adapter Example hbacmd getfipparams 10 00 00 00 c9 5b 3a 6d OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 5 CLI Client Command Descriptions 85 2 EMULEX iSCSI Commands SetFIPParam This command sets the FIP parameters of the OneConnect adapter in FCoE mode Supported By Linux Solaris VMware ESX and Windows Syntax SetFIPParam lt WWPN gt Param Value Parameters WWPN The WWPN of the adapter Param The FIP parameter name e pfabric e pswitch e vlanid e fcmap e cinvlanid Value The value based on the FIP parameter name e pfabric 8 byte fabric name format XX XX XX XX XX XX XX XX e pswitch 8 byte switch name format XX XX XX XX XX XX XX XX e vlanid 2 byte VLAN ID 0 4095 or any for any VLANID e fcmap 3 byte FC map 0xOEFCxx e cinvlanid 2 byte VLAN ID 0 4095 Example hbacmd setfipparam 10 00 00 00 c9 5b 3a 6d fcmap OxOefc99 iSCSI Commands The commands in this section support the iSCSI interface in the OCM CLI Note iSCSI commands are supported only on OneConnect iSCSI ports The MAC address MAC Address of the UCNA port must be passed to each comman
127. s the same or later than the OneCommand Manager CLI version Note You cannot update a OneCommand Manager CLI with a previous version of the OneCommand Manager application enterprise kit When the OneCommand Vision Sensor software is installed on production servers with Emulex adapters 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 updates to the OneCommand Manager application or HBAnyware software stack components For information on stopping the OneCommand Vision Sensor see the latest Emulex OneCommand Vision Installation and Configuration Manual Linux To update from the OneCommand Manager CLI to the full featured OneCommand Manager application enterprise kit in Linux run the install sh script of the OneCommand Manager application enterprise kit The install script executes an rpm update rpm U rpm to update the installed core kit to an enterprise kit Solaris To update from the OneCommand Manager CLI to the full featured OneCommand Manager application enterprise kit in Solaris 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 kit version tar 3 Change to the newly created elxocm k
128. sername Login User ID of the VMware ESX password The login password of the VMware ESX namespace The namespace where the Emulex provider is registered in the SFCB CIMOM of VMware ESX specifically root emulex portnum The port number of the SFCB CIMOM listening to that is 5988 HTTP or 5989 HTTPS SRIOVEnable This command enables or disables SR IOV on a specified NIC port that is physical function Note This command is not available on OCe11101 EM EX or OCe11102 EM EX adapters The following error will be returned ERROR 251 Hardware or firmware does not support command Supported By Linux Solaris VMware ESX and Windows Syntax SRIOVEnable MAC 0 1 Parameters MAC The MAC address of the port 011 0 Disables SR IOV 1 Enables SR IOV Example The following command enables SR IOV on NIC physical function with MAC address 00 00 c9 12 34 56 hbacmd sriovenable 00 00 c9 12 34 56 1 TargetMapping This command shows a list of mapped targets and the LUNs for the port Supported By Linux Solaris VMware ESX and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 114 Miscellaneous Commands Syntax TargetMapping lt WWPN gt Parameters WWPN The WWPN of the adapter Version This command shows the current version of the OneCommand Manager CLI Client Supported By Linux Solaris VMwa
129. t command Parameters host address The host to remove IP Address The IP address of the host to remove Reset This command resets the adapter An adapter reset can reguire several seconds to complete especially for remote devices When the reset is completed the system command prompt is displayed Notes e Supported for FC and FCoE ports only e 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 Linux Solaris VMware ESX and Windows Syntax Reset lt WWPN gt Parameters WWPN The WWPN of the adapter SetCimCred This command sets the default CIM credentials You must specify all four credentials username password namespace and port number 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 Supported By Windows Syntax SetCimCred username password namespace lt portnum gt OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 113 Miscellaneous Commands 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 Parameters u
130. t enclosed in quotes string length 12 16 Initiator CHAP name enclosed in quotes string length 1 256 Initiator Secret enclosed in quotes string length 12 16 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 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 Each string should be enclosed in quotations to avoid mishandling by the Windows Linux Solaris or VMware shell s parser e Ifyou set the authentication method to One Way CHAP lt Auth gt 1 you must also specify the Target CHAP Name and Target Secret For example hbacmd AddTargetPortal 00 11 22 33 44 55 10 0 0 1 8000 Auth 1 TgtCHAPName TargetSecretl e If you set the authentication method to Mutual CHAP lt Auth gt 2 you must specify all four values For example hbacmd AddTargetPortal 00 11 22 33 44 55 10 0 0 1 8000 Auth 2 TgtChapName TargetSecretl InitCHAPName InitialSecret1 You must specify either the TSIH value or the ISID qualifier If you specify the ISID qualifier you must also specify the Target s ID address OneCommand Manager Command Line Interface Version 6 3 User Manual P0094
131. t1 Supported By Linux Solaris VMware ESX and Windows Syntax AddTarget MAC Address Target IP Port lt iscsi target name ImmediateData lt 0 1 gt HeaderDigest lt 0 1 gt DataDigest lt 0 1 gt Boot 0 1 Login lt 0 1 gt Auth lt 0 1 2 gt TgtCHAPName TgtSecret InitCHAPName InitSecret Parameters MAC Address The MAC address of the UCNA port Target IP IP address of the target portal Port Port number of the target portal value 102 65535 iscsi target name Targe siSCSI name enclosed in quotes string length 11 255 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX ImnediateData HeaderDigest DataDigest Boot Login Auth TgtCHAPNam TgtSecret InitCHAPName InitSecret AddTargetPortal 5 CLI Client Command Descriptions 88 iSCSI Commands 0 No 1 Yes default 0 None default 1 CRC32C 0 None default 1 CRC32C This optional parameter specifies whether the added target is a boot device 0 Added target is not a boot device 1 Added target is a boot device This optional parameter specifies whether to log in to the target after it has been added 0 Do not log in to the target 1 Specify log in to the target If the Login parameter is omitted the default is 1 0 None default 1 One Way CHAP 2 Mutual CHAP Target CHAP name enclosed in quotes string length 1 256 Target Secre
132. tLunUnMaskByHBA GetLunUnMaskByTarget and SetLunMask commands e Solaris and VMware ESX do not support the GetLunUnMaskbyHBA GetLunUnMaskbyTarget RescanLuns and SetLunMask commands GetLunList This command queries for the presence of any masked LUNs Supported By Linux Solaris and Windows Syntax GetLunList lt HBA WWPN gt lt Target WWPN gt lt Option gt Parameters HBA WWPN The WWPN of the adapter Target WWPN The WWPN of the target Option 0 Get information from the driver 1 Get information from the configuration GetLunUnMaskByHBA This command queries for the presence of any unmasked LUNs by adapter Supported By Solaris and Windows Syntax GetLunUnMaskByHBA lt HBA WWPN gt lt Option gt Parameters HBA WWPN The WWPN of the adapter Option 0 Get information from the driver 1 Get information from the configuration OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is S CLI Client Command Descriptions 106 DG EMULEX LUN Masking Commands GetLunUnMaskByTarget This command queries for any unmasked LUNs by target Supported By Solaris and Windows Syntax GetLunUnMaskByTarget lt HBA WWPN gt lt Target WWPN gt lt Option gt Parameters HBA WWPN The WWPN of the adapter Target WWPN The WWPN of the target Option 0 Get information from the driver 1 Get information from the configuration RescanLuns This command rescans LUNs to find
133. tStats This command shows all the port statistics for a specified port Supported By Linux Solaris VMware ESX and Windows Syntax GetiSCSIPortStats MAC Address Parameters MAC Address The MAC address of the UCNA port GetNetworkConfiguration This command lists a port s TCP IP information Supported By Linux Solaris VMware ESX and Windows Syntax GetNetworkConfiguration MAC Address Parameters MAC Address The MAC address of the UCNA port GetSessionlnfo This command lists all session information for a specified session You must specify the lt iscsi target name gt and either the lt TSIH gt of the session or the session s ISID Qualifier lt ISID_Qual gt and the targe 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 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 5 CLI Client Command Descriptions gt lt EMULEX iSCSI Commands 93 Supported By Linux Solaris VMware ESX and Windows Syntax GetSessionInfo MAC Address lt iscsi target name lt TSIH lt ISID Qual Target 1P gt gt Parameters MAC Address The MAC address of the UCNA port iscsi target name Targe siSCSI name enclosed in quotes string length 11 255 TSIH TSIH value of the session value 1 65535 ISID Qual ISID qual
134. tall the OneCommand Manager CLI from a VMware ESX server 1 Log in to the ESX server COS 2 Type rpm e elxocmcore esxNN lt kit version gt e NN is the VMware ESX version It is 41 fora VMware ESX 4 1 Uninstalling an Older HBAnyware or a OneCommand Manager Kit in a VMware ESX Server To uninstall an older HBAnyware or OneCommand Manager from a VMware server 1 Log in to the ESX server COS 2 Type rpm ga grep elx Locate either of the following rpm files elxvmwarecorekit lt kit version gt elxocmcore esxNN lt kit version gt e NN is the VMware ESX version It is 41 for VMware ESX 4 1 3 Type one of the following rpm e elxvmwarecorekit lt kit version gt rpm e elxocmcore esxNN lt kit version gt e NN is the VMware ESX version It is 41 for VMware ESX 4 1 Installing the CIM Provider for VMware ESXi Hosts For VMware ESXi 4 1 ESXi 5 0 and VMware ESXi 5 1 hosts you can manage adapters using the OneCommand Manager on Windows but you must install and use the appropriate Emulex CIM Provider VMware ESXi comes with an inbox Emulex CIM Provider The inbox Emulex CIM Provider enables you to manage Emulex LightPulse adapters but not Emulex UCNAs To manage Emulex UCNAs you must install the out of box Emulex CIM Provider The Emulex CIM Provider is available as an offline bundle in ESXi platforms VMware recommends using the offline bundle to update software on VMware platforms For more
135. ters WWPN1 The WWPN of the adapter WWPN2 Use ff ff ff ff ff ff ff ff for a switch or use the WWPN for a target PasswordType 1 ASCII 2 Hex binary 3 gt Password not yet defined Password The current password value GetAuthConfig This command retrieves the authentication configuration for the adapter Supported By Linux Solaris and Windows Syntax hbacmd GetAuthConfig WWPN1 lt WWPN2 gt Parameters WWPN1 The WWPN of the adapter WWPN2 Use ff ff ff ff ff ff ff ff for a switch or use the WWPN for a target GetAuthStatus This command returns the current status for the authentication connection specified by WWPN 1 and WWPN2 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 Supported By Linux Solaris and Windows OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 58 Authentication Commands Syntax GetAuthStatus WWPN1 lt WWPN2 gt Parameters WWPN1 The WWPN of the adapter WWPN2 Use ff ff ff ff ff ff ff ff for a switch or use the WWPN for a target InitiateAuth This command initiates the authentication configuration on the adapter Supported By Linux Solaris and Windows Syntax
136. tes e ListHbas e ListVPorts e PortAttributes e PortStatistics e Reset e SaveConfig e ServerAttributes e SetDriverParam e SetDriverParamDefaults e SetPortEnabled e SetRetentionCount 4 CLI Client Command Usage Unsupported Commands per Operating System Unsupported Commands per Operating System For a list of all the supported commands see Table 5 1 CLI Client Command Reference on page 43 Linux RHEL SLES and Oracle RHEL SLES and Oracle do not support the following CLI commands e BindingCapabilities e BindingSupport e GetCimCred e GetLunUnMaskByHBA e GetLunUnMaskByTarget OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 39 2G EMULEX ListVMs PersistentBinding RemoveAllPersistentBinding RemovePersistentBinding SetBindingSupport SetCimCred SetDumpbDirectory SetLunMask SetPersistentBinding Citrix Citrix acting as a hypervisor style server for OneCommand Manager CLI does not support the following CLI commands Solaris AuthConfigList BindingCapabilities BindingSupport CreateVPort DeleteVPort GetAuthConfig GetAuthStatus GetCimCred GetElxSecInfo GetLunList GetLunUnMaskByHBA GetLunUnMaskBy Target InitiateAuth PersistentBinding RemoveAllPersistentBinding RemovePersistentBinding RescanLuns SetAuthConfig SetBindingSupport SetCimCred SetPersistentBinding SetLunMask SetPassword Solaris does not support the following CLI commands OneCo
137. th Estimation invalid Pair C Open Distance to Fault 38m Pair D Shorted Distance to Fault 36m Wakeup Note Not supported for OneConnect adapters This command wakes up the adapter Supported By Linux Solaris VMware ESX and Windows Syntax Wakeup lt WWPN gt Parameters WWPN The WWPN of the adapter Driver Parameter Commands Notes e Supported for FC and FCoE ports only e Driver parameters that are set to temporary or global values using the T and G flags respectively must be read using the GetDriverParams command to view the current value of the parameter The GetDriverParamsGlobal command returns only permanently set driver parameter values Additionally if temporary and global values have been set for one or more driver parameters the SaveConfig command must be run with the N flag using the N flag is analogous to the GetDriverParams command 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 e The DriverConfig and SetDriverParamDefaults commands are not supported for Solaris OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A DE EMULEX 5 CLI Client Command Descriptions 77 Driver Parameter Commands DriverConfig This command sets all driver parameters to the values in the dpv file type The dpv fil s driver type must match the driv
138. the core kit rpm e elxlinuxcorekit Uninstalling an Older HBAnyware Enterprise Kit 1 Do one of the following e Run the uninstall script located in usr sbin hbanyware scripts to remove the enterprise kit e 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 2 If the 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 ne S Run the uninstall script with the ssc parameter specified Type uninstall ssc 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 Solaris Installing in Solaris Note Prior to installation OneCommand groups must be configured on the LDAP network or the local host machine for Secure Management operation
139. ties When prompted choose whether or not to enable Secure Management for OneCommand Do you want to enable Secure Management feature for OneCommand s u Enter s to select secure management LDAP NIS OCM group configuration required Enter u to run without secure management default Enter the letter s or u Uninstalling in Solaris To uninstall the OneCommand Manager CLI in Solaris 1 2 Log in as root Do one of the following e Run opt ELXocm scripts uninstall e Run the uninstall script located in the installation tar file e Enter the command pkgrm ELXocmcore OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A is 2 Installing and Uninstalling the CLI 22 2G EMULEX VMware ESX ESXi VMware ESX ESXi For installing and uninstalling the OneCommand Manager in VMware ESX only VMware ESX 4 1 is supported For VMware ESXi 4 1 VMware ESXi 5 0 and ESXi 5 1 hosts you must install and use the appropriate Emulex CIM Provider See Installing the CIM Provider for VMware ESXi Hosts on page 23 Installing in a New VMware ESX Server To install the OneCommand Manager CLI in a new VMware ESX system install the specific rpm file for the driver for your VMware ESX version The prerequisites for installation include the following e To manage FCoE adapters the LPFC driver version 8 2 or later must be loaded e To manage NIC FCoE or iSCSI adapters d
140. ty group bandwidth physical layer power on self test Pre boot Execution Environment Red Hat Enterprise Linux remote management resource package manager storage area network Small Computer System Interface Small Footprint CIM Broker small form factor pluggable SUSE Linux Enterprise Server single root I O virtualization Secure Shell Transmission Control Protocol time domain reflectometer universal converged network adapter Unified Extensible Firmware Interface Universal Fabric Port Universal Multichannel vital product data virtual port world wide name world wide node name world wide port name virtual machine extensible markup language OneCommand Manager Secure Management Overview OneCommand Manager Secure Management gives system administrators the ability to further enhance the active management security of their networks Using Secure Management administrators can define each user s privileges for managing both local OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 1 Introduction 14 DG EMULEX OneCommand Manager Secure Management and remote adapters When running in Secure Management mode users must log on with their user name and password to run the OneCommand Manager application When users are authenticated they can only perform the functions allowed by the OneCommand Manager user group to which they belong If your systems are running in an LDAP or Active Directory doma
141. vered SAN elements e Configure COMSTAR COmmon Multiprotocol SCSI TARget for Solaris 11 enabling the Emulex FC driver for Solaris EMLXS to make a host appear as a target to the SAN COMSTAR ports are supported on Solaris 11 with LightPulse FC HBAs only Compatibility The OneCommand Manager application can be installed on multiple operating systems Windows Linux Solaris and VMware ESX and ESXi For VMware ESXi 4 1 ESXi 5 0 and ESXi 5 1 hosts you can manage adapters using the OneCommand Manager on Windows but you must install and use the appropriate Emulex CIM Provider on those VMware hosts Note For VMware ESXi 5 0 and ESXi 5 1 hosts when advanced adapter management capabilities are required for example iSCSI Management and port disable use the OneCommand Manager for VMware vCenter software plug in For more details see the OneCommand Manager for VMware vCenter User Manual For supported versions of operating systems platforms and adapters see the Emulex website Abbreviations ARP address resolution protocol ASIC application specific integrated circuit BIOS basic input output system OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX CEE CHAP CIM CIMOM CIN CLI COS CSV DAC D ID DCB DCBX DH DHCHAP ETO FAT FC FCoE FIP GUI HBA iBFT ICMP IP iSCSI iSNS LACP LLDP LPFC LPVID LUN MAC MSI MTU NFS NIC NPVID OneCommand Manager Command Line
142. y Linux Solaris VMware ESX and Windows Syntax SaveConfig lt WWPN gt lt FileName gt lt Flag gt Parameters WWPN The WWPN of the adapter FileName Name of the file that contains the driver parameters list Flag G Save the global parameter set N Save the local adapter specific parameter set SetDriverParam This command changes a driver parameter and designates the scope of the change Supported By Linux Solaris VMware ESX and Windows Syntax SetDriverParam WWPN Flagl Flag2 Param Value Parameters WWPN The WWPN of the adapter Flagl 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 hexadecimal OxNNN OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2G EMULEX 5 CLI Client Command Descriptions 79 Dump Commands SetDriverParamDefaults This command changes all values to the default for the adapter s Supported By Linux VMware ESX and Windows Syntax SetDriverParamDefaults lt WWPN gt lt Flagl gt lt Flag2 gt Parameters WWPN The WWPN of the adapter Flagl L gt Make change local for this adapter only G Make change global applies to all adapters on this host Flag2 P Make change permanent the change persists across reb
143. 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 Version 6 3 User Manual P009403 01A Rev A Table of Contents 2G EMULEX Table of Contents Ts Introductions rr cc 10 OVE VIEW MC 10 Compatibility Peer D davka kk ok vin 11 PDDPEVIAUIONS M 11 OneCommand Manager Secure Management eeeeeeeeeeee eee eene nnne 13 B RA m 13 OCM Secure Management Configuration Requirements cessere 15 Secure Management Installation 2 5e cesses eere
144. y za sa ko koks br Sa novo vn nooo 90 DiscoveriSNSServer esee eee eese ok sa oka svo K naa eee a ni VER e E ee E ee gu 90 EXDPOMtISCS T 91 OneCommand Manager Command Line Interface Version 6 3 User Manual P009403 01A Rev A 2c EMULEX Table of Contents 7 GetlnitiatorProperties ccceeseeeeeeeee eee e nnne nnne 91 GEeti gt CSI UNS ia sadov nn hn nr vv 91 ere reip T 92 GetNetworkConfig ration 44 caves esee pn reta oa ar RR kv pa ERR dU PP ER ok 92 GELSESSIONING e s T 92 nissim E EEE EE SEENE 93 MES DII PI vod la prin REEERE EERE E R ERER RE REREN Eaei 94 Brie m M 94 REMOVE LANGet scs T M 94 RemoveTargetPortal ccccccccceesscecceeeeeeeeeeeeseesseeeeeeeeeeeeeeeeesgaaareeeeeees 95 SetBootTargetSession ise ceseseedecsieededees eer y eere raa Ra v io ees 95 SetinitiatorProperties averse ee ore ene I Idee ua piva kovy NEN DESEE S Ca SEE E EON DRE deg ete 96 SCLISCSIBOOE MM TOT 97 SetNetworkConfiguration sssisssss sakus vasuosk dnva k R ER EREP VE ERE WEE NERA kovo s V ERR EE WES 97 SetTargetLoginProperties csseeseeeeeeeeeeeeee eene enne ehh hne 98 SetTargetPropertles 4 cecus eese ees ure RR Ra nn n EN as E Ure Ese e Ee v orn 99 SetTPLoginProperties ee er eter Rn EE as Ex rn eden seve v ERR EFE ENEE 99 ShawARPTaDIG e

Download Pdf Manuals

image

Related Search

Related Contents

クリスタルプリンセスロッド 取扱説明書  5 - lokalmatador.de  König OSP-FX1122A loudspeaker  dreamGEAR Twist Speaker  「道の情報」CARDGETアプケーション取り扱い説明書  Wireless ADSL2+ Modem Router DG834Gv5 User Manual  HERMA Labels Premium A4 70x50.8 mm white paper matt 3000 pcs.  UK/0126/0064  Bose bose am268612_00_v User's Manual  Document  

Copyright © All rights reserved.
Failed to retrieve file