Embed Size (px)
Citation preview
HP VMware Utilities User GuideVMware vSphere 55 for September 2013
HP Part Number 670557-406Published September 2013Edition 8
copy Copyright 2007 2013 Hewlett-Packard Development Company LP
Confidential computer software Valid license from HP required for possession use or copying Consistent with FAR 12211 and 12212 CommercialComputer Software Computer Software Documentation and Technical Data for Commercial Items are licensed to the US Government undervendors standard commercial license The information contained herein is subject to change without notice The only warranties for HP productsand services are set forth in the express warranty statements accompanying such products and services Nothing herein should be construed asconstituting an additional warranty HP shall not be liable for technical or editorial errors or omissions contained herein UNIX is a registeredtrademark of The Open Group
Acknowledgments
Microsoft Windows is US registered trademarks of Microsoft Corporation
UNIX is a registered trademark of The Open Group
Contents1 Introduction4
Installing offline bundles on an vSphere 55 and updates host using vSphere CLI 50 esxcli utility4Prerequisites4
Installing offline bundles on an vSphere 55 and updates host using VMware vCenter UpdateManager4HPONCFG utility5
HPONCFG command-line syntax5HPONCFG return codes6HPONCFG command file contents6Obtaining an entire configuration6Obtaining a specific configuration7Setting a configuration8HPONCFG command-line examples8
HPBOOTCFG utility9HPBOOTCFG command-line syntax9HPBOOTCFG ESXCLI syntax9HPBOOTCFG return codes10HPBOOTCFG command-line examples10
HPSSACLI utility10HPSSACLI command-line syntax10HPSSACLI ESXCLI syntax11
HPTESTEVENT utility13HPTESTEVENT command-line syntax13HPTESTEVENT ESXCLI syntax14HPTESTEVENT return codes14HPTESTEVENT command-line examples14
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates142 Support and other resources16
Contacting HP 16Before you contact HP16HP contact information16Subscription service16Documentation feedback16
New and changed information in this edition 17Related information17
Documents17Websites17
Typographic conventions17Index19
Contents 3
1 IntroductionThis section provides information about the utilities supported on VMware vSphere 55 and updatesThe following utilities are supported on VMware vSphere 55 and updates hostbull HPONCFGmdash Command line utility used for obtaining and setting ProLiant iLO configurations
bull HPBOOTCFG mdash Command line utility used for configuring ProLiant server boot order
bull HPSSACLI ndash Command line utility used for configuration and diagnostics of ProLiant serverSmartArrays
Installing offline bundles on an vSphere 55 and updates host using vSphereCLI 50 esxcli utility
This section provides information about installing the VMware vSphere 55 updates offline bundleson the vSphere host You can use the esxcli utility in conjunction with offline bundles or with adepot
PrerequisitesInstall VMware vSphere Command-Line Interface 50(vSphere CLI) on MicrosoftWindows or Linux system For information about importing or installing the vSphere CLI 50see the VMware vSphere Command-Line Interface Installation and Reference Guide available athttppubsvmwarecomvsphere-50topiccomvmwarevclirefdoc_50vcli-righthtmlTo install the offline bundle on an vSphere host perform the following steps1 Power off any virtual machines that are running on the host and set the host into maintenance
mode2 Transfer the bundle onto the vSphere host local path or extract it onto an online depot3 Install the bundle on the vSphere host using any of the following command line
bull Install remotely from client with offline bundle available as online depot~ esxcli -s ltservergt -u root -p mypassword software vib install-d ltdepotURLbundle-indexxmlgt
bull Install remotely from client with offline bundle available on vSphere host~ esxcli -s ltservergt -u root -p mypassword software vib install-d ltvSphere local pathgtltbundlezipgt
bull Install from vSphere host with offline bundle available on vSphere host~ esxcli software vib install -d ltvSphere local pathgtltbundlezipgt
4 After the bundle is installed reboot the vSphere host to initialize the utilities
Installing offline bundles on an vSphere 55 and updates host usingVMware vCenter Update Manager
The offline bundle can also be installed from VMware vCenter Update Manager as a patch Formore information and detailed instructions see the VMware vCenter Update Manager AdministrationGuide available athttppubsvmwarecomvsphere-50topiccomvmwarevsphereupdate_managerdoc_50GUID-F7191592-048B-40C7-A610-CFEE6A790AB0html
4 Introduction
HPONCFG utilityThe HPONFCG utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionHP offers support for the iLO 2 iLO 3 and iLO 4 features available on ProLiant servers with theHPONCFG utilityHPONCFG is an online configuration tool used to set up and reconfigure iLO 2 iLO3 and iLO 4without requiring a reboot of the server operating system The utility runs in a command-line modeand must be executed from an operating system command-lineObserve the following requirements before using HPONCFGbull The iLO 2 iLO 3 or iLO 4 Management Interface Driver must be loaded on the server HPONCFG
displays a warning if the driver is not installedbull HPONCFG requires minimum iLO 2 iLO 3 and iLO 4 firmware versions To determine the
minimum firmware version required see the HP SmartStart Scripting Toolkit Linux andWindowsEditions Support Matrix
For more information see the Remote Management websitehttpwwwhpcomserverslights-out
HPONCFG command-line syntaxUse the following format at the command linehponcfg -f filename [-l filename] [-v] [-m minFw] -g [-m minFw] -wfilename [-m minFw] -r [-m minFw ] -h -
The HPONCFG utility can be accessed from the location opthptools
IMPORTANT Because the-w argument does not capture certain types of information such asthe administrator password data files created with HPONCFG using the-w argument cannot thenbe used as input files for HPONCFG unless they are modified first
Table 1 hponcfg Command Line Arguments
FunctionArgument
This argument captures complete Management Processor configuration to thefile This option should be used along with the -w option
-a --all
This argument GetSet Management Processor Configuration from the XMLinput received through the standard input stream
-i --input
This argument substitutes variables present in the input configuration file withthe values specified in namevaluepairs
-s--substitute
This argument sets the iLO 2 iLO 3 or iLO 4 configuration based on theinformation in the XML input file named filename
-f - -file=filename
This argument logs replies to the text log file named filename-l - -log=filename
Writes all the responses from iLO 2 iLO 3 or iLO 4-v - -xmlverbose
This argument returns the host server name and serial number-g - -get_hostinfo
This argument indicates to HPONCFG the minimum firmware level that must bepresent in the management device to execute the RIBCL script If the minimum
-m - -minfwlevel
level is not met HPONCFG returns an error without performing any additionalactions
This argument writes the iLO 2 iLO 3 or iLO 4 configuration obtained from thedevice to the XML output file named filename
-w - -writeconfig=filename
HPONCFG utility 5
Table 1 hponcfg Command Line Arguments (continued)
FunctionArgument
This argument resets the iLO 2 iLO 3 or iLO 4 to factory defaults-r - -reset
These arguments display simple help messages-h - -help - -
HPONCFG return codesThis section provides description about the return code after running the command
Table 2 hponcfg return codes
MeaningValue
ERROR A general system error detected while running HPONCFG-1
Script succeeded0
Script failed1
ERROR Unable to shutdown the iLo Channel Interface2
Firmware flash is in progress Please wait for a while3
General error detected while checking firmware flash4
iLO Lights-Out functionality is Disabled5Please enable Lights-Out functionality before using this softwareTo Enable Lights-Out functionalitySet iLO Security Override Switch to ON andUse iLO ROM-based Setup Utility or iLO Browser interface to enable lights-outfunctionality
You are not a rootsuperuser Only rootsuperuser can access the utility7
ERROR Please specify firmware level as numeric input9
Could not get status of the Lights-Out Functionality10
ERROR Failed to capture the configuration13 - 20
If the script itself fails errors are reported in the log file created by HPONCFG
HPONCFG command file contentsThe hponcfg command can be used to perform the following tasks
bull Obtain an entire configuration
bull Obtain a specific configuration
bull Set a configuration
Obtaining an entire configurationThe hponcfg command can be used to obtain an entire configuration from an iLO 2 iLO 3 oriLO 4 In this case the utility executes from the command line without specification of an input fileThe name of the output file is given on the command line For exampleopthptools hponcfg -w configxml
In this example the utility indicated that it obtained the data successfully and wrote it to the outputfile as requested The following is a typical example of the contents of the output file
ltHPONCFG VERSION=11gt ltndashGenerated 041504 152036mdashgt
6 Introduction
ltMOD_DIR_CONFIGgt ltDIR_AUTHENTICATION_ENABLED VALUE=N gt ltDIR_LOCAL_USER_ACCT VALUE=Y gt ltDIR_SERVER_ADDRESS VALUE=gt ltDIR_SERVER_PORT VALUE=25gt ltDIR_OBJECT_DN VALUE= gt ltDIR_OBJECT_PASSWORD VALUE=gt ltDIR_USER_CONTEXT_1 VALUE=gt ltDIR_USER_CONTEXT_2 VALUE=_gt ltDIR_USER_CONTEXT_3 VALUE=gt ltMOD_DIR_CONFIGgt ltMOD_NETWORK_SETTINGSgt ltSPEED_AUTOSELECT VALUE=Ygt ltNIC_SPEED VALUE=100gt ltFULL_DUPLEX VALUE=Ygt ltIP_ADDRESS VALUE=XXXXXXXXXXgt ltSUBNET_MASK VALUE=xxxxxxxxxxgt ltGATEWAY_IP_ADDRESS VALUE=XXXXXXXXXgt ltDNS_NAME VALUE=ILOD234KJ44D002gt ltPRIM_DNS_SERVER value=xxxxxxxxgt ltDHCP_ENABLE VALUE=Ygt ltDOMAIN_NAME VALUE=americascpqcorpnetgt ltDHCP_GATEWAY VALUE=Ygt ltDHCP_DNS_SERVER VALUE=Ygt ltDHCP_STATIC_ROUTE VALUE=Ygt ltDHCP_WINS_SERVER VALUE=Ygt ltREG_WINS_SERVER VALUE=Ygt ltPRIM_WINS_SERVER value=xxxxxxxxgt ltSTATIC_ROUTE_1 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_2 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_3 DEST=0000 GATEWAY=0000gt ltMOD_NETWORK_SETTINGSgt ltADD_USER USER_NAME=Administrator USER_LOGIN=Administrator PASSWORD=gt ltADD_USERgt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=gt ltADD_USERgt ltRESET_RIB VALUE=Ygt ltHPONCFGgt
For security reasons the user passwords are not returned
Obtaining a specific configurationA specific configuration can be obtained using the appropriate XML input file For example hereare the contents of a typical XML input file get_globalxml
lt-- Sample file for Get Global command --gt ltRIBCL VERSION=20gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltRIB_INFO MODE=readgt ltGET_GLOBAL_SETTINGS gt ltRIB_INFOgt ltLOGINgt ltRIBCLgt
The XML commands are read from the input file get_globalxml and are processed by thedeviceopthptools hponcfg -f get_globalxml -l logtxt gt outputtxt
HPONCFG utility 7
The requested information is returned in the log file which in this example is named logtxtThe contents of the log file are shown below
ltGET_GLOBAL_SETTINGSgt ltSESSION_TIMEOUT VALUE=30gt ltILO_FUNCT_ENABLED VALUE=Ygt ltF8_PROMPT_ENABLED VALUE=Ygt ltREMOTE_CONSOLE_PORT_STATUS VALUE=3gt ltREMOTE_CONSOLE_ENCRYPTION VALUE=Ngt ltPREFER_TERMINAL_SERVICES VALUE=Ngt ltHTTPS_PORT VALUE=443gt ltHTTP_PORT VALUE=80gt ltREMOTE_CONSOLE_PORT VALUE=23gt ltTERMINAL_SERVICES_PORT VALUE=3389gt ltVIRTUAL_MEDIA_PORT VALUE=17988gt ltMIN_PASSWORD VALUE=4gt ltGET_GLOBAL_SETTINGSgt
Setting a configurationA specific configuration can be sent to the iLO 2 iLO 3 or iLO 4 by using the command formatopthptools hponcfg -f add_userxml -l logtxt
In this example the input file has contents
ltndashAdd user with minimal privileges to test default setting of assigned privileges to Nmdashgt ltRIBCL version=12gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltUSER_INFO MODE=writegt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=floppyshoesgt ltRESET_SERVER_PRIV value=Y gt ltADMIN_PRIV value=Y gt ltADD_USERgt ltUSER_INFOgt ltLOGINgt ltRIBCLgt
The specified user will be added to the device
HPONCFG command-line examplesThis section provides sample examples to run the utility
Table 3 hponcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationhponcfg -h
This argument returns the host server name and serial numberhponcfg -g
To view the command usage options run the following commandopthptools hponcfg mdashh
All options supported by the command are listed in the outputTo get the host server name and serial number run the following commandopthptools hponcfg mdashg
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo Host Information Server Name localhostamericashpqcorpnet Server Number 000000000
To set the minimum firmware level run the following command
8 Introduction
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
copy Copyright 2007 2013 Hewlett-Packard Development Company LP
Confidential computer software Valid license from HP required for possession use or copying Consistent with FAR 12211 and 12212 CommercialComputer Software Computer Software Documentation and Technical Data for Commercial Items are licensed to the US Government undervendors standard commercial license The information contained herein is subject to change without notice The only warranties for HP productsand services are set forth in the express warranty statements accompanying such products and services Nothing herein should be construed asconstituting an additional warranty HP shall not be liable for technical or editorial errors or omissions contained herein UNIX is a registeredtrademark of The Open Group
Acknowledgments
Microsoft Windows is US registered trademarks of Microsoft Corporation
UNIX is a registered trademark of The Open Group
Contents1 Introduction4
Installing offline bundles on an vSphere 55 and updates host using vSphere CLI 50 esxcli utility4Prerequisites4
Installing offline bundles on an vSphere 55 and updates host using VMware vCenter UpdateManager4HPONCFG utility5
HPONCFG command-line syntax5HPONCFG return codes6HPONCFG command file contents6Obtaining an entire configuration6Obtaining a specific configuration7Setting a configuration8HPONCFG command-line examples8
HPBOOTCFG utility9HPBOOTCFG command-line syntax9HPBOOTCFG ESXCLI syntax9HPBOOTCFG return codes10HPBOOTCFG command-line examples10
HPSSACLI utility10HPSSACLI command-line syntax10HPSSACLI ESXCLI syntax11
HPTESTEVENT utility13HPTESTEVENT command-line syntax13HPTESTEVENT ESXCLI syntax14HPTESTEVENT return codes14HPTESTEVENT command-line examples14
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates142 Support and other resources16
Contacting HP 16Before you contact HP16HP contact information16Subscription service16Documentation feedback16
New and changed information in this edition 17Related information17
Documents17Websites17
Typographic conventions17Index19
Contents 3
1 IntroductionThis section provides information about the utilities supported on VMware vSphere 55 and updatesThe following utilities are supported on VMware vSphere 55 and updates hostbull HPONCFGmdash Command line utility used for obtaining and setting ProLiant iLO configurations
bull HPBOOTCFG mdash Command line utility used for configuring ProLiant server boot order
bull HPSSACLI ndash Command line utility used for configuration and diagnostics of ProLiant serverSmartArrays
Installing offline bundles on an vSphere 55 and updates host using vSphereCLI 50 esxcli utility
This section provides information about installing the VMware vSphere 55 updates offline bundleson the vSphere host You can use the esxcli utility in conjunction with offline bundles or with adepot
PrerequisitesInstall VMware vSphere Command-Line Interface 50(vSphere CLI) on MicrosoftWindows or Linux system For information about importing or installing the vSphere CLI 50see the VMware vSphere Command-Line Interface Installation and Reference Guide available athttppubsvmwarecomvsphere-50topiccomvmwarevclirefdoc_50vcli-righthtmlTo install the offline bundle on an vSphere host perform the following steps1 Power off any virtual machines that are running on the host and set the host into maintenance
mode2 Transfer the bundle onto the vSphere host local path or extract it onto an online depot3 Install the bundle on the vSphere host using any of the following command line
bull Install remotely from client with offline bundle available as online depot~ esxcli -s ltservergt -u root -p mypassword software vib install-d ltdepotURLbundle-indexxmlgt
bull Install remotely from client with offline bundle available on vSphere host~ esxcli -s ltservergt -u root -p mypassword software vib install-d ltvSphere local pathgtltbundlezipgt
bull Install from vSphere host with offline bundle available on vSphere host~ esxcli software vib install -d ltvSphere local pathgtltbundlezipgt
4 After the bundle is installed reboot the vSphere host to initialize the utilities
Installing offline bundles on an vSphere 55 and updates host usingVMware vCenter Update Manager
The offline bundle can also be installed from VMware vCenter Update Manager as a patch Formore information and detailed instructions see the VMware vCenter Update Manager AdministrationGuide available athttppubsvmwarecomvsphere-50topiccomvmwarevsphereupdate_managerdoc_50GUID-F7191592-048B-40C7-A610-CFEE6A790AB0html
4 Introduction
HPONCFG utilityThe HPONFCG utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionHP offers support for the iLO 2 iLO 3 and iLO 4 features available on ProLiant servers with theHPONCFG utilityHPONCFG is an online configuration tool used to set up and reconfigure iLO 2 iLO3 and iLO 4without requiring a reboot of the server operating system The utility runs in a command-line modeand must be executed from an operating system command-lineObserve the following requirements before using HPONCFGbull The iLO 2 iLO 3 or iLO 4 Management Interface Driver must be loaded on the server HPONCFG
displays a warning if the driver is not installedbull HPONCFG requires minimum iLO 2 iLO 3 and iLO 4 firmware versions To determine the
minimum firmware version required see the HP SmartStart Scripting Toolkit Linux andWindowsEditions Support Matrix
For more information see the Remote Management websitehttpwwwhpcomserverslights-out
HPONCFG command-line syntaxUse the following format at the command linehponcfg -f filename [-l filename] [-v] [-m minFw] -g [-m minFw] -wfilename [-m minFw] -r [-m minFw ] -h -
The HPONCFG utility can be accessed from the location opthptools
IMPORTANT Because the-w argument does not capture certain types of information such asthe administrator password data files created with HPONCFG using the-w argument cannot thenbe used as input files for HPONCFG unless they are modified first
Table 1 hponcfg Command Line Arguments
FunctionArgument
This argument captures complete Management Processor configuration to thefile This option should be used along with the -w option
-a --all
This argument GetSet Management Processor Configuration from the XMLinput received through the standard input stream
-i --input
This argument substitutes variables present in the input configuration file withthe values specified in namevaluepairs
-s--substitute
This argument sets the iLO 2 iLO 3 or iLO 4 configuration based on theinformation in the XML input file named filename
-f - -file=filename
This argument logs replies to the text log file named filename-l - -log=filename
Writes all the responses from iLO 2 iLO 3 or iLO 4-v - -xmlverbose
This argument returns the host server name and serial number-g - -get_hostinfo
This argument indicates to HPONCFG the minimum firmware level that must bepresent in the management device to execute the RIBCL script If the minimum
-m - -minfwlevel
level is not met HPONCFG returns an error without performing any additionalactions
This argument writes the iLO 2 iLO 3 or iLO 4 configuration obtained from thedevice to the XML output file named filename
-w - -writeconfig=filename
HPONCFG utility 5
Table 1 hponcfg Command Line Arguments (continued)
FunctionArgument
This argument resets the iLO 2 iLO 3 or iLO 4 to factory defaults-r - -reset
These arguments display simple help messages-h - -help - -
HPONCFG return codesThis section provides description about the return code after running the command
Table 2 hponcfg return codes
MeaningValue
ERROR A general system error detected while running HPONCFG-1
Script succeeded0
Script failed1
ERROR Unable to shutdown the iLo Channel Interface2
Firmware flash is in progress Please wait for a while3
General error detected while checking firmware flash4
iLO Lights-Out functionality is Disabled5Please enable Lights-Out functionality before using this softwareTo Enable Lights-Out functionalitySet iLO Security Override Switch to ON andUse iLO ROM-based Setup Utility or iLO Browser interface to enable lights-outfunctionality
You are not a rootsuperuser Only rootsuperuser can access the utility7
ERROR Please specify firmware level as numeric input9
Could not get status of the Lights-Out Functionality10
ERROR Failed to capture the configuration13 - 20
If the script itself fails errors are reported in the log file created by HPONCFG
HPONCFG command file contentsThe hponcfg command can be used to perform the following tasks
bull Obtain an entire configuration
bull Obtain a specific configuration
bull Set a configuration
Obtaining an entire configurationThe hponcfg command can be used to obtain an entire configuration from an iLO 2 iLO 3 oriLO 4 In this case the utility executes from the command line without specification of an input fileThe name of the output file is given on the command line For exampleopthptools hponcfg -w configxml
In this example the utility indicated that it obtained the data successfully and wrote it to the outputfile as requested The following is a typical example of the contents of the output file
ltHPONCFG VERSION=11gt ltndashGenerated 041504 152036mdashgt
6 Introduction
ltMOD_DIR_CONFIGgt ltDIR_AUTHENTICATION_ENABLED VALUE=N gt ltDIR_LOCAL_USER_ACCT VALUE=Y gt ltDIR_SERVER_ADDRESS VALUE=gt ltDIR_SERVER_PORT VALUE=25gt ltDIR_OBJECT_DN VALUE= gt ltDIR_OBJECT_PASSWORD VALUE=gt ltDIR_USER_CONTEXT_1 VALUE=gt ltDIR_USER_CONTEXT_2 VALUE=_gt ltDIR_USER_CONTEXT_3 VALUE=gt ltMOD_DIR_CONFIGgt ltMOD_NETWORK_SETTINGSgt ltSPEED_AUTOSELECT VALUE=Ygt ltNIC_SPEED VALUE=100gt ltFULL_DUPLEX VALUE=Ygt ltIP_ADDRESS VALUE=XXXXXXXXXXgt ltSUBNET_MASK VALUE=xxxxxxxxxxgt ltGATEWAY_IP_ADDRESS VALUE=XXXXXXXXXgt ltDNS_NAME VALUE=ILOD234KJ44D002gt ltPRIM_DNS_SERVER value=xxxxxxxxgt ltDHCP_ENABLE VALUE=Ygt ltDOMAIN_NAME VALUE=americascpqcorpnetgt ltDHCP_GATEWAY VALUE=Ygt ltDHCP_DNS_SERVER VALUE=Ygt ltDHCP_STATIC_ROUTE VALUE=Ygt ltDHCP_WINS_SERVER VALUE=Ygt ltREG_WINS_SERVER VALUE=Ygt ltPRIM_WINS_SERVER value=xxxxxxxxgt ltSTATIC_ROUTE_1 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_2 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_3 DEST=0000 GATEWAY=0000gt ltMOD_NETWORK_SETTINGSgt ltADD_USER USER_NAME=Administrator USER_LOGIN=Administrator PASSWORD=gt ltADD_USERgt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=gt ltADD_USERgt ltRESET_RIB VALUE=Ygt ltHPONCFGgt
For security reasons the user passwords are not returned
Obtaining a specific configurationA specific configuration can be obtained using the appropriate XML input file For example hereare the contents of a typical XML input file get_globalxml
lt-- Sample file for Get Global command --gt ltRIBCL VERSION=20gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltRIB_INFO MODE=readgt ltGET_GLOBAL_SETTINGS gt ltRIB_INFOgt ltLOGINgt ltRIBCLgt
The XML commands are read from the input file get_globalxml and are processed by thedeviceopthptools hponcfg -f get_globalxml -l logtxt gt outputtxt
HPONCFG utility 7
The requested information is returned in the log file which in this example is named logtxtThe contents of the log file are shown below
ltGET_GLOBAL_SETTINGSgt ltSESSION_TIMEOUT VALUE=30gt ltILO_FUNCT_ENABLED VALUE=Ygt ltF8_PROMPT_ENABLED VALUE=Ygt ltREMOTE_CONSOLE_PORT_STATUS VALUE=3gt ltREMOTE_CONSOLE_ENCRYPTION VALUE=Ngt ltPREFER_TERMINAL_SERVICES VALUE=Ngt ltHTTPS_PORT VALUE=443gt ltHTTP_PORT VALUE=80gt ltREMOTE_CONSOLE_PORT VALUE=23gt ltTERMINAL_SERVICES_PORT VALUE=3389gt ltVIRTUAL_MEDIA_PORT VALUE=17988gt ltMIN_PASSWORD VALUE=4gt ltGET_GLOBAL_SETTINGSgt
Setting a configurationA specific configuration can be sent to the iLO 2 iLO 3 or iLO 4 by using the command formatopthptools hponcfg -f add_userxml -l logtxt
In this example the input file has contents
ltndashAdd user with minimal privileges to test default setting of assigned privileges to Nmdashgt ltRIBCL version=12gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltUSER_INFO MODE=writegt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=floppyshoesgt ltRESET_SERVER_PRIV value=Y gt ltADMIN_PRIV value=Y gt ltADD_USERgt ltUSER_INFOgt ltLOGINgt ltRIBCLgt
The specified user will be added to the device
HPONCFG command-line examplesThis section provides sample examples to run the utility
Table 3 hponcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationhponcfg -h
This argument returns the host server name and serial numberhponcfg -g
To view the command usage options run the following commandopthptools hponcfg mdashh
All options supported by the command are listed in the outputTo get the host server name and serial number run the following commandopthptools hponcfg mdashg
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo Host Information Server Name localhostamericashpqcorpnet Server Number 000000000
To set the minimum firmware level run the following command
8 Introduction
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
Contents1 Introduction4
Installing offline bundles on an vSphere 55 and updates host using vSphere CLI 50 esxcli utility4Prerequisites4
Installing offline bundles on an vSphere 55 and updates host using VMware vCenter UpdateManager4HPONCFG utility5
HPONCFG command-line syntax5HPONCFG return codes6HPONCFG command file contents6Obtaining an entire configuration6Obtaining a specific configuration7Setting a configuration8HPONCFG command-line examples8
HPBOOTCFG utility9HPBOOTCFG command-line syntax9HPBOOTCFG ESXCLI syntax9HPBOOTCFG return codes10HPBOOTCFG command-line examples10
HPSSACLI utility10HPSSACLI command-line syntax10HPSSACLI ESXCLI syntax11
HPTESTEVENT utility13HPTESTEVENT command-line syntax13HPTESTEVENT ESXCLI syntax14HPTESTEVENT return codes14HPTESTEVENT command-line examples14
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates142 Support and other resources16
Contacting HP 16Before you contact HP16HP contact information16Subscription service16Documentation feedback16
New and changed information in this edition 17Related information17
Documents17Websites17
Typographic conventions17Index19
Contents 3
1 IntroductionThis section provides information about the utilities supported on VMware vSphere 55 and updatesThe following utilities are supported on VMware vSphere 55 and updates hostbull HPONCFGmdash Command line utility used for obtaining and setting ProLiant iLO configurations
bull HPBOOTCFG mdash Command line utility used for configuring ProLiant server boot order
bull HPSSACLI ndash Command line utility used for configuration and diagnostics of ProLiant serverSmartArrays
Installing offline bundles on an vSphere 55 and updates host using vSphereCLI 50 esxcli utility
This section provides information about installing the VMware vSphere 55 updates offline bundleson the vSphere host You can use the esxcli utility in conjunction with offline bundles or with adepot
PrerequisitesInstall VMware vSphere Command-Line Interface 50(vSphere CLI) on MicrosoftWindows or Linux system For information about importing or installing the vSphere CLI 50see the VMware vSphere Command-Line Interface Installation and Reference Guide available athttppubsvmwarecomvsphere-50topiccomvmwarevclirefdoc_50vcli-righthtmlTo install the offline bundle on an vSphere host perform the following steps1 Power off any virtual machines that are running on the host and set the host into maintenance
mode2 Transfer the bundle onto the vSphere host local path or extract it onto an online depot3 Install the bundle on the vSphere host using any of the following command line
bull Install remotely from client with offline bundle available as online depot~ esxcli -s ltservergt -u root -p mypassword software vib install-d ltdepotURLbundle-indexxmlgt
bull Install remotely from client with offline bundle available on vSphere host~ esxcli -s ltservergt -u root -p mypassword software vib install-d ltvSphere local pathgtltbundlezipgt
bull Install from vSphere host with offline bundle available on vSphere host~ esxcli software vib install -d ltvSphere local pathgtltbundlezipgt
4 After the bundle is installed reboot the vSphere host to initialize the utilities
Installing offline bundles on an vSphere 55 and updates host usingVMware vCenter Update Manager
The offline bundle can also be installed from VMware vCenter Update Manager as a patch Formore information and detailed instructions see the VMware vCenter Update Manager AdministrationGuide available athttppubsvmwarecomvsphere-50topiccomvmwarevsphereupdate_managerdoc_50GUID-F7191592-048B-40C7-A610-CFEE6A790AB0html
4 Introduction
HPONCFG utilityThe HPONFCG utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionHP offers support for the iLO 2 iLO 3 and iLO 4 features available on ProLiant servers with theHPONCFG utilityHPONCFG is an online configuration tool used to set up and reconfigure iLO 2 iLO3 and iLO 4without requiring a reboot of the server operating system The utility runs in a command-line modeand must be executed from an operating system command-lineObserve the following requirements before using HPONCFGbull The iLO 2 iLO 3 or iLO 4 Management Interface Driver must be loaded on the server HPONCFG
displays a warning if the driver is not installedbull HPONCFG requires minimum iLO 2 iLO 3 and iLO 4 firmware versions To determine the
minimum firmware version required see the HP SmartStart Scripting Toolkit Linux andWindowsEditions Support Matrix
For more information see the Remote Management websitehttpwwwhpcomserverslights-out
HPONCFG command-line syntaxUse the following format at the command linehponcfg -f filename [-l filename] [-v] [-m minFw] -g [-m minFw] -wfilename [-m minFw] -r [-m minFw ] -h -
The HPONCFG utility can be accessed from the location opthptools
IMPORTANT Because the-w argument does not capture certain types of information such asthe administrator password data files created with HPONCFG using the-w argument cannot thenbe used as input files for HPONCFG unless they are modified first
Table 1 hponcfg Command Line Arguments
FunctionArgument
This argument captures complete Management Processor configuration to thefile This option should be used along with the -w option
-a --all
This argument GetSet Management Processor Configuration from the XMLinput received through the standard input stream
-i --input
This argument substitutes variables present in the input configuration file withthe values specified in namevaluepairs
-s--substitute
This argument sets the iLO 2 iLO 3 or iLO 4 configuration based on theinformation in the XML input file named filename
-f - -file=filename
This argument logs replies to the text log file named filename-l - -log=filename
Writes all the responses from iLO 2 iLO 3 or iLO 4-v - -xmlverbose
This argument returns the host server name and serial number-g - -get_hostinfo
This argument indicates to HPONCFG the minimum firmware level that must bepresent in the management device to execute the RIBCL script If the minimum
-m - -minfwlevel
level is not met HPONCFG returns an error without performing any additionalactions
This argument writes the iLO 2 iLO 3 or iLO 4 configuration obtained from thedevice to the XML output file named filename
-w - -writeconfig=filename
HPONCFG utility 5
Table 1 hponcfg Command Line Arguments (continued)
FunctionArgument
This argument resets the iLO 2 iLO 3 or iLO 4 to factory defaults-r - -reset
These arguments display simple help messages-h - -help - -
HPONCFG return codesThis section provides description about the return code after running the command
Table 2 hponcfg return codes
MeaningValue
ERROR A general system error detected while running HPONCFG-1
Script succeeded0
Script failed1
ERROR Unable to shutdown the iLo Channel Interface2
Firmware flash is in progress Please wait for a while3
General error detected while checking firmware flash4
iLO Lights-Out functionality is Disabled5Please enable Lights-Out functionality before using this softwareTo Enable Lights-Out functionalitySet iLO Security Override Switch to ON andUse iLO ROM-based Setup Utility or iLO Browser interface to enable lights-outfunctionality
You are not a rootsuperuser Only rootsuperuser can access the utility7
ERROR Please specify firmware level as numeric input9
Could not get status of the Lights-Out Functionality10
ERROR Failed to capture the configuration13 - 20
If the script itself fails errors are reported in the log file created by HPONCFG
HPONCFG command file contentsThe hponcfg command can be used to perform the following tasks
bull Obtain an entire configuration
bull Obtain a specific configuration
bull Set a configuration
Obtaining an entire configurationThe hponcfg command can be used to obtain an entire configuration from an iLO 2 iLO 3 oriLO 4 In this case the utility executes from the command line without specification of an input fileThe name of the output file is given on the command line For exampleopthptools hponcfg -w configxml
In this example the utility indicated that it obtained the data successfully and wrote it to the outputfile as requested The following is a typical example of the contents of the output file
ltHPONCFG VERSION=11gt ltndashGenerated 041504 152036mdashgt
6 Introduction
ltMOD_DIR_CONFIGgt ltDIR_AUTHENTICATION_ENABLED VALUE=N gt ltDIR_LOCAL_USER_ACCT VALUE=Y gt ltDIR_SERVER_ADDRESS VALUE=gt ltDIR_SERVER_PORT VALUE=25gt ltDIR_OBJECT_DN VALUE= gt ltDIR_OBJECT_PASSWORD VALUE=gt ltDIR_USER_CONTEXT_1 VALUE=gt ltDIR_USER_CONTEXT_2 VALUE=_gt ltDIR_USER_CONTEXT_3 VALUE=gt ltMOD_DIR_CONFIGgt ltMOD_NETWORK_SETTINGSgt ltSPEED_AUTOSELECT VALUE=Ygt ltNIC_SPEED VALUE=100gt ltFULL_DUPLEX VALUE=Ygt ltIP_ADDRESS VALUE=XXXXXXXXXXgt ltSUBNET_MASK VALUE=xxxxxxxxxxgt ltGATEWAY_IP_ADDRESS VALUE=XXXXXXXXXgt ltDNS_NAME VALUE=ILOD234KJ44D002gt ltPRIM_DNS_SERVER value=xxxxxxxxgt ltDHCP_ENABLE VALUE=Ygt ltDOMAIN_NAME VALUE=americascpqcorpnetgt ltDHCP_GATEWAY VALUE=Ygt ltDHCP_DNS_SERVER VALUE=Ygt ltDHCP_STATIC_ROUTE VALUE=Ygt ltDHCP_WINS_SERVER VALUE=Ygt ltREG_WINS_SERVER VALUE=Ygt ltPRIM_WINS_SERVER value=xxxxxxxxgt ltSTATIC_ROUTE_1 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_2 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_3 DEST=0000 GATEWAY=0000gt ltMOD_NETWORK_SETTINGSgt ltADD_USER USER_NAME=Administrator USER_LOGIN=Administrator PASSWORD=gt ltADD_USERgt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=gt ltADD_USERgt ltRESET_RIB VALUE=Ygt ltHPONCFGgt
For security reasons the user passwords are not returned
Obtaining a specific configurationA specific configuration can be obtained using the appropriate XML input file For example hereare the contents of a typical XML input file get_globalxml
lt-- Sample file for Get Global command --gt ltRIBCL VERSION=20gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltRIB_INFO MODE=readgt ltGET_GLOBAL_SETTINGS gt ltRIB_INFOgt ltLOGINgt ltRIBCLgt
The XML commands are read from the input file get_globalxml and are processed by thedeviceopthptools hponcfg -f get_globalxml -l logtxt gt outputtxt
HPONCFG utility 7
The requested information is returned in the log file which in this example is named logtxtThe contents of the log file are shown below
ltGET_GLOBAL_SETTINGSgt ltSESSION_TIMEOUT VALUE=30gt ltILO_FUNCT_ENABLED VALUE=Ygt ltF8_PROMPT_ENABLED VALUE=Ygt ltREMOTE_CONSOLE_PORT_STATUS VALUE=3gt ltREMOTE_CONSOLE_ENCRYPTION VALUE=Ngt ltPREFER_TERMINAL_SERVICES VALUE=Ngt ltHTTPS_PORT VALUE=443gt ltHTTP_PORT VALUE=80gt ltREMOTE_CONSOLE_PORT VALUE=23gt ltTERMINAL_SERVICES_PORT VALUE=3389gt ltVIRTUAL_MEDIA_PORT VALUE=17988gt ltMIN_PASSWORD VALUE=4gt ltGET_GLOBAL_SETTINGSgt
Setting a configurationA specific configuration can be sent to the iLO 2 iLO 3 or iLO 4 by using the command formatopthptools hponcfg -f add_userxml -l logtxt
In this example the input file has contents
ltndashAdd user with minimal privileges to test default setting of assigned privileges to Nmdashgt ltRIBCL version=12gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltUSER_INFO MODE=writegt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=floppyshoesgt ltRESET_SERVER_PRIV value=Y gt ltADMIN_PRIV value=Y gt ltADD_USERgt ltUSER_INFOgt ltLOGINgt ltRIBCLgt
The specified user will be added to the device
HPONCFG command-line examplesThis section provides sample examples to run the utility
Table 3 hponcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationhponcfg -h
This argument returns the host server name and serial numberhponcfg -g
To view the command usage options run the following commandopthptools hponcfg mdashh
All options supported by the command are listed in the outputTo get the host server name and serial number run the following commandopthptools hponcfg mdashg
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo Host Information Server Name localhostamericashpqcorpnet Server Number 000000000
To set the minimum firmware level run the following command
8 Introduction
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
1 IntroductionThis section provides information about the utilities supported on VMware vSphere 55 and updatesThe following utilities are supported on VMware vSphere 55 and updates hostbull HPONCFGmdash Command line utility used for obtaining and setting ProLiant iLO configurations
bull HPBOOTCFG mdash Command line utility used for configuring ProLiant server boot order
bull HPSSACLI ndash Command line utility used for configuration and diagnostics of ProLiant serverSmartArrays
Installing offline bundles on an vSphere 55 and updates host using vSphereCLI 50 esxcli utility
This section provides information about installing the VMware vSphere 55 updates offline bundleson the vSphere host You can use the esxcli utility in conjunction with offline bundles or with adepot
PrerequisitesInstall VMware vSphere Command-Line Interface 50(vSphere CLI) on MicrosoftWindows or Linux system For information about importing or installing the vSphere CLI 50see the VMware vSphere Command-Line Interface Installation and Reference Guide available athttppubsvmwarecomvsphere-50topiccomvmwarevclirefdoc_50vcli-righthtmlTo install the offline bundle on an vSphere host perform the following steps1 Power off any virtual machines that are running on the host and set the host into maintenance
mode2 Transfer the bundle onto the vSphere host local path or extract it onto an online depot3 Install the bundle on the vSphere host using any of the following command line
bull Install remotely from client with offline bundle available as online depot~ esxcli -s ltservergt -u root -p mypassword software vib install-d ltdepotURLbundle-indexxmlgt
bull Install remotely from client with offline bundle available on vSphere host~ esxcli -s ltservergt -u root -p mypassword software vib install-d ltvSphere local pathgtltbundlezipgt
bull Install from vSphere host with offline bundle available on vSphere host~ esxcli software vib install -d ltvSphere local pathgtltbundlezipgt
4 After the bundle is installed reboot the vSphere host to initialize the utilities
Installing offline bundles on an vSphere 55 and updates host usingVMware vCenter Update Manager
The offline bundle can also be installed from VMware vCenter Update Manager as a patch Formore information and detailed instructions see the VMware vCenter Update Manager AdministrationGuide available athttppubsvmwarecomvsphere-50topiccomvmwarevsphereupdate_managerdoc_50GUID-F7191592-048B-40C7-A610-CFEE6A790AB0html
4 Introduction
HPONCFG utilityThe HPONFCG utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionHP offers support for the iLO 2 iLO 3 and iLO 4 features available on ProLiant servers with theHPONCFG utilityHPONCFG is an online configuration tool used to set up and reconfigure iLO 2 iLO3 and iLO 4without requiring a reboot of the server operating system The utility runs in a command-line modeand must be executed from an operating system command-lineObserve the following requirements before using HPONCFGbull The iLO 2 iLO 3 or iLO 4 Management Interface Driver must be loaded on the server HPONCFG
displays a warning if the driver is not installedbull HPONCFG requires minimum iLO 2 iLO 3 and iLO 4 firmware versions To determine the
minimum firmware version required see the HP SmartStart Scripting Toolkit Linux andWindowsEditions Support Matrix
For more information see the Remote Management websitehttpwwwhpcomserverslights-out
HPONCFG command-line syntaxUse the following format at the command linehponcfg -f filename [-l filename] [-v] [-m minFw] -g [-m minFw] -wfilename [-m minFw] -r [-m minFw ] -h -
The HPONCFG utility can be accessed from the location opthptools
IMPORTANT Because the-w argument does not capture certain types of information such asthe administrator password data files created with HPONCFG using the-w argument cannot thenbe used as input files for HPONCFG unless they are modified first
Table 1 hponcfg Command Line Arguments
FunctionArgument
This argument captures complete Management Processor configuration to thefile This option should be used along with the -w option
-a --all
This argument GetSet Management Processor Configuration from the XMLinput received through the standard input stream
-i --input
This argument substitutes variables present in the input configuration file withthe values specified in namevaluepairs
-s--substitute
This argument sets the iLO 2 iLO 3 or iLO 4 configuration based on theinformation in the XML input file named filename
-f - -file=filename
This argument logs replies to the text log file named filename-l - -log=filename
Writes all the responses from iLO 2 iLO 3 or iLO 4-v - -xmlverbose
This argument returns the host server name and serial number-g - -get_hostinfo
This argument indicates to HPONCFG the minimum firmware level that must bepresent in the management device to execute the RIBCL script If the minimum
-m - -minfwlevel
level is not met HPONCFG returns an error without performing any additionalactions
This argument writes the iLO 2 iLO 3 or iLO 4 configuration obtained from thedevice to the XML output file named filename
-w - -writeconfig=filename
HPONCFG utility 5
Table 1 hponcfg Command Line Arguments (continued)
FunctionArgument
This argument resets the iLO 2 iLO 3 or iLO 4 to factory defaults-r - -reset
These arguments display simple help messages-h - -help - -
HPONCFG return codesThis section provides description about the return code after running the command
Table 2 hponcfg return codes
MeaningValue
ERROR A general system error detected while running HPONCFG-1
Script succeeded0
Script failed1
ERROR Unable to shutdown the iLo Channel Interface2
Firmware flash is in progress Please wait for a while3
General error detected while checking firmware flash4
iLO Lights-Out functionality is Disabled5Please enable Lights-Out functionality before using this softwareTo Enable Lights-Out functionalitySet iLO Security Override Switch to ON andUse iLO ROM-based Setup Utility or iLO Browser interface to enable lights-outfunctionality
You are not a rootsuperuser Only rootsuperuser can access the utility7
ERROR Please specify firmware level as numeric input9
Could not get status of the Lights-Out Functionality10
ERROR Failed to capture the configuration13 - 20
If the script itself fails errors are reported in the log file created by HPONCFG
HPONCFG command file contentsThe hponcfg command can be used to perform the following tasks
bull Obtain an entire configuration
bull Obtain a specific configuration
bull Set a configuration
Obtaining an entire configurationThe hponcfg command can be used to obtain an entire configuration from an iLO 2 iLO 3 oriLO 4 In this case the utility executes from the command line without specification of an input fileThe name of the output file is given on the command line For exampleopthptools hponcfg -w configxml
In this example the utility indicated that it obtained the data successfully and wrote it to the outputfile as requested The following is a typical example of the contents of the output file
ltHPONCFG VERSION=11gt ltndashGenerated 041504 152036mdashgt
6 Introduction
ltMOD_DIR_CONFIGgt ltDIR_AUTHENTICATION_ENABLED VALUE=N gt ltDIR_LOCAL_USER_ACCT VALUE=Y gt ltDIR_SERVER_ADDRESS VALUE=gt ltDIR_SERVER_PORT VALUE=25gt ltDIR_OBJECT_DN VALUE= gt ltDIR_OBJECT_PASSWORD VALUE=gt ltDIR_USER_CONTEXT_1 VALUE=gt ltDIR_USER_CONTEXT_2 VALUE=_gt ltDIR_USER_CONTEXT_3 VALUE=gt ltMOD_DIR_CONFIGgt ltMOD_NETWORK_SETTINGSgt ltSPEED_AUTOSELECT VALUE=Ygt ltNIC_SPEED VALUE=100gt ltFULL_DUPLEX VALUE=Ygt ltIP_ADDRESS VALUE=XXXXXXXXXXgt ltSUBNET_MASK VALUE=xxxxxxxxxxgt ltGATEWAY_IP_ADDRESS VALUE=XXXXXXXXXgt ltDNS_NAME VALUE=ILOD234KJ44D002gt ltPRIM_DNS_SERVER value=xxxxxxxxgt ltDHCP_ENABLE VALUE=Ygt ltDOMAIN_NAME VALUE=americascpqcorpnetgt ltDHCP_GATEWAY VALUE=Ygt ltDHCP_DNS_SERVER VALUE=Ygt ltDHCP_STATIC_ROUTE VALUE=Ygt ltDHCP_WINS_SERVER VALUE=Ygt ltREG_WINS_SERVER VALUE=Ygt ltPRIM_WINS_SERVER value=xxxxxxxxgt ltSTATIC_ROUTE_1 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_2 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_3 DEST=0000 GATEWAY=0000gt ltMOD_NETWORK_SETTINGSgt ltADD_USER USER_NAME=Administrator USER_LOGIN=Administrator PASSWORD=gt ltADD_USERgt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=gt ltADD_USERgt ltRESET_RIB VALUE=Ygt ltHPONCFGgt
For security reasons the user passwords are not returned
Obtaining a specific configurationA specific configuration can be obtained using the appropriate XML input file For example hereare the contents of a typical XML input file get_globalxml
lt-- Sample file for Get Global command --gt ltRIBCL VERSION=20gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltRIB_INFO MODE=readgt ltGET_GLOBAL_SETTINGS gt ltRIB_INFOgt ltLOGINgt ltRIBCLgt
The XML commands are read from the input file get_globalxml and are processed by thedeviceopthptools hponcfg -f get_globalxml -l logtxt gt outputtxt
HPONCFG utility 7
The requested information is returned in the log file which in this example is named logtxtThe contents of the log file are shown below
ltGET_GLOBAL_SETTINGSgt ltSESSION_TIMEOUT VALUE=30gt ltILO_FUNCT_ENABLED VALUE=Ygt ltF8_PROMPT_ENABLED VALUE=Ygt ltREMOTE_CONSOLE_PORT_STATUS VALUE=3gt ltREMOTE_CONSOLE_ENCRYPTION VALUE=Ngt ltPREFER_TERMINAL_SERVICES VALUE=Ngt ltHTTPS_PORT VALUE=443gt ltHTTP_PORT VALUE=80gt ltREMOTE_CONSOLE_PORT VALUE=23gt ltTERMINAL_SERVICES_PORT VALUE=3389gt ltVIRTUAL_MEDIA_PORT VALUE=17988gt ltMIN_PASSWORD VALUE=4gt ltGET_GLOBAL_SETTINGSgt
Setting a configurationA specific configuration can be sent to the iLO 2 iLO 3 or iLO 4 by using the command formatopthptools hponcfg -f add_userxml -l logtxt
In this example the input file has contents
ltndashAdd user with minimal privileges to test default setting of assigned privileges to Nmdashgt ltRIBCL version=12gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltUSER_INFO MODE=writegt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=floppyshoesgt ltRESET_SERVER_PRIV value=Y gt ltADMIN_PRIV value=Y gt ltADD_USERgt ltUSER_INFOgt ltLOGINgt ltRIBCLgt
The specified user will be added to the device
HPONCFG command-line examplesThis section provides sample examples to run the utility
Table 3 hponcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationhponcfg -h
This argument returns the host server name and serial numberhponcfg -g
To view the command usage options run the following commandopthptools hponcfg mdashh
All options supported by the command are listed in the outputTo get the host server name and serial number run the following commandopthptools hponcfg mdashg
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo Host Information Server Name localhostamericashpqcorpnet Server Number 000000000
To set the minimum firmware level run the following command
8 Introduction
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
HPONCFG utilityThe HPONFCG utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionHP offers support for the iLO 2 iLO 3 and iLO 4 features available on ProLiant servers with theHPONCFG utilityHPONCFG is an online configuration tool used to set up and reconfigure iLO 2 iLO3 and iLO 4without requiring a reboot of the server operating system The utility runs in a command-line modeand must be executed from an operating system command-lineObserve the following requirements before using HPONCFGbull The iLO 2 iLO 3 or iLO 4 Management Interface Driver must be loaded on the server HPONCFG
displays a warning if the driver is not installedbull HPONCFG requires minimum iLO 2 iLO 3 and iLO 4 firmware versions To determine the
minimum firmware version required see the HP SmartStart Scripting Toolkit Linux andWindowsEditions Support Matrix
For more information see the Remote Management websitehttpwwwhpcomserverslights-out
HPONCFG command-line syntaxUse the following format at the command linehponcfg -f filename [-l filename] [-v] [-m minFw] -g [-m minFw] -wfilename [-m minFw] -r [-m minFw ] -h -
The HPONCFG utility can be accessed from the location opthptools
IMPORTANT Because the-w argument does not capture certain types of information such asthe administrator password data files created with HPONCFG using the-w argument cannot thenbe used as input files for HPONCFG unless they are modified first
Table 1 hponcfg Command Line Arguments
FunctionArgument
This argument captures complete Management Processor configuration to thefile This option should be used along with the -w option
-a --all
This argument GetSet Management Processor Configuration from the XMLinput received through the standard input stream
-i --input
This argument substitutes variables present in the input configuration file withthe values specified in namevaluepairs
-s--substitute
This argument sets the iLO 2 iLO 3 or iLO 4 configuration based on theinformation in the XML input file named filename
-f - -file=filename
This argument logs replies to the text log file named filename-l - -log=filename
Writes all the responses from iLO 2 iLO 3 or iLO 4-v - -xmlverbose
This argument returns the host server name and serial number-g - -get_hostinfo
This argument indicates to HPONCFG the minimum firmware level that must bepresent in the management device to execute the RIBCL script If the minimum
-m - -minfwlevel
level is not met HPONCFG returns an error without performing any additionalactions
This argument writes the iLO 2 iLO 3 or iLO 4 configuration obtained from thedevice to the XML output file named filename
-w - -writeconfig=filename
HPONCFG utility 5
Table 1 hponcfg Command Line Arguments (continued)
FunctionArgument
This argument resets the iLO 2 iLO 3 or iLO 4 to factory defaults-r - -reset
These arguments display simple help messages-h - -help - -
HPONCFG return codesThis section provides description about the return code after running the command
Table 2 hponcfg return codes
MeaningValue
ERROR A general system error detected while running HPONCFG-1
Script succeeded0
Script failed1
ERROR Unable to shutdown the iLo Channel Interface2
Firmware flash is in progress Please wait for a while3
General error detected while checking firmware flash4
iLO Lights-Out functionality is Disabled5Please enable Lights-Out functionality before using this softwareTo Enable Lights-Out functionalitySet iLO Security Override Switch to ON andUse iLO ROM-based Setup Utility or iLO Browser interface to enable lights-outfunctionality
You are not a rootsuperuser Only rootsuperuser can access the utility7
ERROR Please specify firmware level as numeric input9
Could not get status of the Lights-Out Functionality10
ERROR Failed to capture the configuration13 - 20
If the script itself fails errors are reported in the log file created by HPONCFG
HPONCFG command file contentsThe hponcfg command can be used to perform the following tasks
bull Obtain an entire configuration
bull Obtain a specific configuration
bull Set a configuration
Obtaining an entire configurationThe hponcfg command can be used to obtain an entire configuration from an iLO 2 iLO 3 oriLO 4 In this case the utility executes from the command line without specification of an input fileThe name of the output file is given on the command line For exampleopthptools hponcfg -w configxml
In this example the utility indicated that it obtained the data successfully and wrote it to the outputfile as requested The following is a typical example of the contents of the output file
ltHPONCFG VERSION=11gt ltndashGenerated 041504 152036mdashgt
6 Introduction
ltMOD_DIR_CONFIGgt ltDIR_AUTHENTICATION_ENABLED VALUE=N gt ltDIR_LOCAL_USER_ACCT VALUE=Y gt ltDIR_SERVER_ADDRESS VALUE=gt ltDIR_SERVER_PORT VALUE=25gt ltDIR_OBJECT_DN VALUE= gt ltDIR_OBJECT_PASSWORD VALUE=gt ltDIR_USER_CONTEXT_1 VALUE=gt ltDIR_USER_CONTEXT_2 VALUE=_gt ltDIR_USER_CONTEXT_3 VALUE=gt ltMOD_DIR_CONFIGgt ltMOD_NETWORK_SETTINGSgt ltSPEED_AUTOSELECT VALUE=Ygt ltNIC_SPEED VALUE=100gt ltFULL_DUPLEX VALUE=Ygt ltIP_ADDRESS VALUE=XXXXXXXXXXgt ltSUBNET_MASK VALUE=xxxxxxxxxxgt ltGATEWAY_IP_ADDRESS VALUE=XXXXXXXXXgt ltDNS_NAME VALUE=ILOD234KJ44D002gt ltPRIM_DNS_SERVER value=xxxxxxxxgt ltDHCP_ENABLE VALUE=Ygt ltDOMAIN_NAME VALUE=americascpqcorpnetgt ltDHCP_GATEWAY VALUE=Ygt ltDHCP_DNS_SERVER VALUE=Ygt ltDHCP_STATIC_ROUTE VALUE=Ygt ltDHCP_WINS_SERVER VALUE=Ygt ltREG_WINS_SERVER VALUE=Ygt ltPRIM_WINS_SERVER value=xxxxxxxxgt ltSTATIC_ROUTE_1 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_2 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_3 DEST=0000 GATEWAY=0000gt ltMOD_NETWORK_SETTINGSgt ltADD_USER USER_NAME=Administrator USER_LOGIN=Administrator PASSWORD=gt ltADD_USERgt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=gt ltADD_USERgt ltRESET_RIB VALUE=Ygt ltHPONCFGgt
For security reasons the user passwords are not returned
Obtaining a specific configurationA specific configuration can be obtained using the appropriate XML input file For example hereare the contents of a typical XML input file get_globalxml
lt-- Sample file for Get Global command --gt ltRIBCL VERSION=20gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltRIB_INFO MODE=readgt ltGET_GLOBAL_SETTINGS gt ltRIB_INFOgt ltLOGINgt ltRIBCLgt
The XML commands are read from the input file get_globalxml and are processed by thedeviceopthptools hponcfg -f get_globalxml -l logtxt gt outputtxt
HPONCFG utility 7
The requested information is returned in the log file which in this example is named logtxtThe contents of the log file are shown below
ltGET_GLOBAL_SETTINGSgt ltSESSION_TIMEOUT VALUE=30gt ltILO_FUNCT_ENABLED VALUE=Ygt ltF8_PROMPT_ENABLED VALUE=Ygt ltREMOTE_CONSOLE_PORT_STATUS VALUE=3gt ltREMOTE_CONSOLE_ENCRYPTION VALUE=Ngt ltPREFER_TERMINAL_SERVICES VALUE=Ngt ltHTTPS_PORT VALUE=443gt ltHTTP_PORT VALUE=80gt ltREMOTE_CONSOLE_PORT VALUE=23gt ltTERMINAL_SERVICES_PORT VALUE=3389gt ltVIRTUAL_MEDIA_PORT VALUE=17988gt ltMIN_PASSWORD VALUE=4gt ltGET_GLOBAL_SETTINGSgt
Setting a configurationA specific configuration can be sent to the iLO 2 iLO 3 or iLO 4 by using the command formatopthptools hponcfg -f add_userxml -l logtxt
In this example the input file has contents
ltndashAdd user with minimal privileges to test default setting of assigned privileges to Nmdashgt ltRIBCL version=12gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltUSER_INFO MODE=writegt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=floppyshoesgt ltRESET_SERVER_PRIV value=Y gt ltADMIN_PRIV value=Y gt ltADD_USERgt ltUSER_INFOgt ltLOGINgt ltRIBCLgt
The specified user will be added to the device
HPONCFG command-line examplesThis section provides sample examples to run the utility
Table 3 hponcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationhponcfg -h
This argument returns the host server name and serial numberhponcfg -g
To view the command usage options run the following commandopthptools hponcfg mdashh
All options supported by the command are listed in the outputTo get the host server name and serial number run the following commandopthptools hponcfg mdashg
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo Host Information Server Name localhostamericashpqcorpnet Server Number 000000000
To set the minimum firmware level run the following command
8 Introduction
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
Table 1 hponcfg Command Line Arguments (continued)
FunctionArgument
This argument resets the iLO 2 iLO 3 or iLO 4 to factory defaults-r - -reset
These arguments display simple help messages-h - -help - -
HPONCFG return codesThis section provides description about the return code after running the command
Table 2 hponcfg return codes
MeaningValue
ERROR A general system error detected while running HPONCFG-1
Script succeeded0
Script failed1
ERROR Unable to shutdown the iLo Channel Interface2
Firmware flash is in progress Please wait for a while3
General error detected while checking firmware flash4
iLO Lights-Out functionality is Disabled5Please enable Lights-Out functionality before using this softwareTo Enable Lights-Out functionalitySet iLO Security Override Switch to ON andUse iLO ROM-based Setup Utility or iLO Browser interface to enable lights-outfunctionality
You are not a rootsuperuser Only rootsuperuser can access the utility7
ERROR Please specify firmware level as numeric input9
Could not get status of the Lights-Out Functionality10
ERROR Failed to capture the configuration13 - 20
If the script itself fails errors are reported in the log file created by HPONCFG
HPONCFG command file contentsThe hponcfg command can be used to perform the following tasks
bull Obtain an entire configuration
bull Obtain a specific configuration
bull Set a configuration
Obtaining an entire configurationThe hponcfg command can be used to obtain an entire configuration from an iLO 2 iLO 3 oriLO 4 In this case the utility executes from the command line without specification of an input fileThe name of the output file is given on the command line For exampleopthptools hponcfg -w configxml
In this example the utility indicated that it obtained the data successfully and wrote it to the outputfile as requested The following is a typical example of the contents of the output file
ltHPONCFG VERSION=11gt ltndashGenerated 041504 152036mdashgt
6 Introduction
ltMOD_DIR_CONFIGgt ltDIR_AUTHENTICATION_ENABLED VALUE=N gt ltDIR_LOCAL_USER_ACCT VALUE=Y gt ltDIR_SERVER_ADDRESS VALUE=gt ltDIR_SERVER_PORT VALUE=25gt ltDIR_OBJECT_DN VALUE= gt ltDIR_OBJECT_PASSWORD VALUE=gt ltDIR_USER_CONTEXT_1 VALUE=gt ltDIR_USER_CONTEXT_2 VALUE=_gt ltDIR_USER_CONTEXT_3 VALUE=gt ltMOD_DIR_CONFIGgt ltMOD_NETWORK_SETTINGSgt ltSPEED_AUTOSELECT VALUE=Ygt ltNIC_SPEED VALUE=100gt ltFULL_DUPLEX VALUE=Ygt ltIP_ADDRESS VALUE=XXXXXXXXXXgt ltSUBNET_MASK VALUE=xxxxxxxxxxgt ltGATEWAY_IP_ADDRESS VALUE=XXXXXXXXXgt ltDNS_NAME VALUE=ILOD234KJ44D002gt ltPRIM_DNS_SERVER value=xxxxxxxxgt ltDHCP_ENABLE VALUE=Ygt ltDOMAIN_NAME VALUE=americascpqcorpnetgt ltDHCP_GATEWAY VALUE=Ygt ltDHCP_DNS_SERVER VALUE=Ygt ltDHCP_STATIC_ROUTE VALUE=Ygt ltDHCP_WINS_SERVER VALUE=Ygt ltREG_WINS_SERVER VALUE=Ygt ltPRIM_WINS_SERVER value=xxxxxxxxgt ltSTATIC_ROUTE_1 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_2 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_3 DEST=0000 GATEWAY=0000gt ltMOD_NETWORK_SETTINGSgt ltADD_USER USER_NAME=Administrator USER_LOGIN=Administrator PASSWORD=gt ltADD_USERgt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=gt ltADD_USERgt ltRESET_RIB VALUE=Ygt ltHPONCFGgt
For security reasons the user passwords are not returned
Obtaining a specific configurationA specific configuration can be obtained using the appropriate XML input file For example hereare the contents of a typical XML input file get_globalxml
lt-- Sample file for Get Global command --gt ltRIBCL VERSION=20gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltRIB_INFO MODE=readgt ltGET_GLOBAL_SETTINGS gt ltRIB_INFOgt ltLOGINgt ltRIBCLgt
The XML commands are read from the input file get_globalxml and are processed by thedeviceopthptools hponcfg -f get_globalxml -l logtxt gt outputtxt
HPONCFG utility 7
The requested information is returned in the log file which in this example is named logtxtThe contents of the log file are shown below
ltGET_GLOBAL_SETTINGSgt ltSESSION_TIMEOUT VALUE=30gt ltILO_FUNCT_ENABLED VALUE=Ygt ltF8_PROMPT_ENABLED VALUE=Ygt ltREMOTE_CONSOLE_PORT_STATUS VALUE=3gt ltREMOTE_CONSOLE_ENCRYPTION VALUE=Ngt ltPREFER_TERMINAL_SERVICES VALUE=Ngt ltHTTPS_PORT VALUE=443gt ltHTTP_PORT VALUE=80gt ltREMOTE_CONSOLE_PORT VALUE=23gt ltTERMINAL_SERVICES_PORT VALUE=3389gt ltVIRTUAL_MEDIA_PORT VALUE=17988gt ltMIN_PASSWORD VALUE=4gt ltGET_GLOBAL_SETTINGSgt
Setting a configurationA specific configuration can be sent to the iLO 2 iLO 3 or iLO 4 by using the command formatopthptools hponcfg -f add_userxml -l logtxt
In this example the input file has contents
ltndashAdd user with minimal privileges to test default setting of assigned privileges to Nmdashgt ltRIBCL version=12gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltUSER_INFO MODE=writegt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=floppyshoesgt ltRESET_SERVER_PRIV value=Y gt ltADMIN_PRIV value=Y gt ltADD_USERgt ltUSER_INFOgt ltLOGINgt ltRIBCLgt
The specified user will be added to the device
HPONCFG command-line examplesThis section provides sample examples to run the utility
Table 3 hponcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationhponcfg -h
This argument returns the host server name and serial numberhponcfg -g
To view the command usage options run the following commandopthptools hponcfg mdashh
All options supported by the command are listed in the outputTo get the host server name and serial number run the following commandopthptools hponcfg mdashg
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo Host Information Server Name localhostamericashpqcorpnet Server Number 000000000
To set the minimum firmware level run the following command
8 Introduction
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
ltMOD_DIR_CONFIGgt ltDIR_AUTHENTICATION_ENABLED VALUE=N gt ltDIR_LOCAL_USER_ACCT VALUE=Y gt ltDIR_SERVER_ADDRESS VALUE=gt ltDIR_SERVER_PORT VALUE=25gt ltDIR_OBJECT_DN VALUE= gt ltDIR_OBJECT_PASSWORD VALUE=gt ltDIR_USER_CONTEXT_1 VALUE=gt ltDIR_USER_CONTEXT_2 VALUE=_gt ltDIR_USER_CONTEXT_3 VALUE=gt ltMOD_DIR_CONFIGgt ltMOD_NETWORK_SETTINGSgt ltSPEED_AUTOSELECT VALUE=Ygt ltNIC_SPEED VALUE=100gt ltFULL_DUPLEX VALUE=Ygt ltIP_ADDRESS VALUE=XXXXXXXXXXgt ltSUBNET_MASK VALUE=xxxxxxxxxxgt ltGATEWAY_IP_ADDRESS VALUE=XXXXXXXXXgt ltDNS_NAME VALUE=ILOD234KJ44D002gt ltPRIM_DNS_SERVER value=xxxxxxxxgt ltDHCP_ENABLE VALUE=Ygt ltDOMAIN_NAME VALUE=americascpqcorpnetgt ltDHCP_GATEWAY VALUE=Ygt ltDHCP_DNS_SERVER VALUE=Ygt ltDHCP_STATIC_ROUTE VALUE=Ygt ltDHCP_WINS_SERVER VALUE=Ygt ltREG_WINS_SERVER VALUE=Ygt ltPRIM_WINS_SERVER value=xxxxxxxxgt ltSTATIC_ROUTE_1 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_2 DEST=0000 GATEWAY=0000gt ltSTATIC_ROUTE_3 DEST=0000 GATEWAY=0000gt ltMOD_NETWORK_SETTINGSgt ltADD_USER USER_NAME=Administrator USER_LOGIN=Administrator PASSWORD=gt ltADD_USERgt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=gt ltADD_USERgt ltRESET_RIB VALUE=Ygt ltHPONCFGgt
For security reasons the user passwords are not returned
Obtaining a specific configurationA specific configuration can be obtained using the appropriate XML input file For example hereare the contents of a typical XML input file get_globalxml
lt-- Sample file for Get Global command --gt ltRIBCL VERSION=20gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltRIB_INFO MODE=readgt ltGET_GLOBAL_SETTINGS gt ltRIB_INFOgt ltLOGINgt ltRIBCLgt
The XML commands are read from the input file get_globalxml and are processed by thedeviceopthptools hponcfg -f get_globalxml -l logtxt gt outputtxt
HPONCFG utility 7
The requested information is returned in the log file which in this example is named logtxtThe contents of the log file are shown below
ltGET_GLOBAL_SETTINGSgt ltSESSION_TIMEOUT VALUE=30gt ltILO_FUNCT_ENABLED VALUE=Ygt ltF8_PROMPT_ENABLED VALUE=Ygt ltREMOTE_CONSOLE_PORT_STATUS VALUE=3gt ltREMOTE_CONSOLE_ENCRYPTION VALUE=Ngt ltPREFER_TERMINAL_SERVICES VALUE=Ngt ltHTTPS_PORT VALUE=443gt ltHTTP_PORT VALUE=80gt ltREMOTE_CONSOLE_PORT VALUE=23gt ltTERMINAL_SERVICES_PORT VALUE=3389gt ltVIRTUAL_MEDIA_PORT VALUE=17988gt ltMIN_PASSWORD VALUE=4gt ltGET_GLOBAL_SETTINGSgt
Setting a configurationA specific configuration can be sent to the iLO 2 iLO 3 or iLO 4 by using the command formatopthptools hponcfg -f add_userxml -l logtxt
In this example the input file has contents
ltndashAdd user with minimal privileges to test default setting of assigned privileges to Nmdashgt ltRIBCL version=12gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltUSER_INFO MODE=writegt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=floppyshoesgt ltRESET_SERVER_PRIV value=Y gt ltADMIN_PRIV value=Y gt ltADD_USERgt ltUSER_INFOgt ltLOGINgt ltRIBCLgt
The specified user will be added to the device
HPONCFG command-line examplesThis section provides sample examples to run the utility
Table 3 hponcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationhponcfg -h
This argument returns the host server name and serial numberhponcfg -g
To view the command usage options run the following commandopthptools hponcfg mdashh
All options supported by the command are listed in the outputTo get the host server name and serial number run the following commandopthptools hponcfg mdashg
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo Host Information Server Name localhostamericashpqcorpnet Server Number 000000000
To set the minimum firmware level run the following command
8 Introduction
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
The requested information is returned in the log file which in this example is named logtxtThe contents of the log file are shown below
ltGET_GLOBAL_SETTINGSgt ltSESSION_TIMEOUT VALUE=30gt ltILO_FUNCT_ENABLED VALUE=Ygt ltF8_PROMPT_ENABLED VALUE=Ygt ltREMOTE_CONSOLE_PORT_STATUS VALUE=3gt ltREMOTE_CONSOLE_ENCRYPTION VALUE=Ngt ltPREFER_TERMINAL_SERVICES VALUE=Ngt ltHTTPS_PORT VALUE=443gt ltHTTP_PORT VALUE=80gt ltREMOTE_CONSOLE_PORT VALUE=23gt ltTERMINAL_SERVICES_PORT VALUE=3389gt ltVIRTUAL_MEDIA_PORT VALUE=17988gt ltMIN_PASSWORD VALUE=4gt ltGET_GLOBAL_SETTINGSgt
Setting a configurationA specific configuration can be sent to the iLO 2 iLO 3 or iLO 4 by using the command formatopthptools hponcfg -f add_userxml -l logtxt
In this example the input file has contents
ltndashAdd user with minimal privileges to test default setting of assigned privileges to Nmdashgt ltRIBCL version=12gt ltLOGIN USER_LOGIN=x PASSWORD=xgt ltUSER_INFO MODE=writegt ltADD_USER USER_NAME=Landy9 USER_LOGIN=mandy9 PASSWORD=floppyshoesgt ltRESET_SERVER_PRIV value=Y gt ltADMIN_PRIV value=Y gt ltADD_USERgt ltUSER_INFOgt ltLOGINgt ltRIBCLgt
The specified user will be added to the device
HPONCFG command-line examplesThis section provides sample examples to run the utility
Table 3 hponcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationhponcfg -h
This argument returns the host server name and serial numberhponcfg -g
To view the command usage options run the following commandopthptools hponcfg mdashh
All options supported by the command are listed in the outputTo get the host server name and serial number run the following commandopthptools hponcfg mdashg
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo Host Information Server Name localhostamericashpqcorpnet Server Number 000000000
To set the minimum firmware level run the following command
8 Introduction
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
opthptools hponcfg mdashm 2
The following output is displayed
Firmware Revision = 205 Device type = iLO 2 Driver name = hpilo
HPBOOTCFG utilityThe hpbootcfg utility only supports HP ProLiant 300500700900 Server series 100 SeriesGen8 servers and HP ProLiant BL Servers that are listed in the vSphere Server Support Matrix Tovisit the vSphere Server Matrix page go to wwwhpcomgovmware and select Certified ProLiantsunder ToolsResource sectionThis utility allows an application to set the device for the next subsequent boot of the system
HPBOOTCFG command-line syntaxUse the following format at the command linehpbootcfg [-F -C -H -T] [-S -Q -R -P] [-r -d -n -b]
Table 4 hpbootcfg Command Line Arguments
FunctionArgument
Sets default device as the boot option-D
Sets Floppy Drive as the first boot device for the system boot-F
Sets CD-ROM Drive as the first boot device for the system boot-C
Sets Hard Drive as the first boot device for the system boot-H
Sets Tape Drive as the first boot device for the system boot-T
Sets system configuration utility as the boot device for the current boot-S
Sets quick configuration utility as the boot device for the current boot-Q
Sets ROM-Based Setup Utility (RBSU) as the boot device for the current boot-R
Sets PXE client as the boot device for the current boot-P
Sets remote configuration as the boot device for the current boot-r
Sets remote dial out as the boot device for the current boot-d
Sets remote network as the boot device for the current boot-n
Bypasses F1 F2 prompts-b
HPBOOTCFG ESXCLI syntaxThe hpbootcfg utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hpbootcfg
The following output is displayed
Usage esxcli hpbootcfg cmd [cmd options]Available Commandsexecute execute mdash hpbootcfg command with options parameterhelp mdash show hpbootcfg helpshow mdash show current hpbootcfg settings
To view the current boot settings run the following command esxcli hpbootcfg show
HPBOOTCFG utility 9
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
The following output is displayed
00 00 Normal Device first normal boot process
To set the command parameter values use the execute cmd and one of the options listed inTable 4 The following is an example of the command to set the defaults esxcli hpbootcfg execute -D
The following output is displayed
00 00 Normal Device first normal boot process
HPBOOTCFG return codesThis section provides description about the return code after running the command
Table 5 hpbootcfg return codes
MeaningValue
Indicates success0
Indicates failureNon zero
HPBOOTCFG command-line examplesThis section provides sample examples to run the utility
Table 6 hpbootcfg command-line examples
DescriptionCommand-line argument
This argument displays help informationopthptoolshpbootcfg -h
This argument sets the default valuesopthptoolshpbootcfg -D
HPSSACLI utilityThe HPSSACLI utility supports HP ProLiant 300500700 and Blade servers with integratedSmartArray controllers and option controllers The utility supports reporting and configuration ofthe SmartArray Configuration includes the ability to create arrays create expand and deletelogical drives and many other advanced operations The information provided in the guide isintroductory and example focused For more information see Configuring Arrays on HP SmartArray Controllers Reference Guide available athttph20000www2hpcombcdocssupportSupportManualc00729544c00729544pdfAdditional references to HP Smart Storage Administrator guides and white papers are availableathttph20000www2hpcombizsupportTechSupportDocumentIndexjsplang=enampcc=usampcontentType=SupportManualampprodTypeId=18964ampprodSeriesId=468780ampdocIndexId=64179
HPSSACLI command-line syntaxUsing VMware esxcli requires knowledge about the CLI usage The VMware vSphere commandline documentation is available at httpwwwvmwarecomsupportdevelopervcliThe following is an overview of the ESXCLI command-line format esxcli namespace object command cmd options ldquocommand-stringrdquo
10 Introduction
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
Table 7 HPSSACLI Command-Line Arguments
FunctionArgument
The esxcli applicationesxcli
Each plugin must have an associated namespace which defines any environment or other systemvariables required by the application
namespace
A plugin must have one or more associated objects which defines a single operationobject
Prepares the esxcli target to accept a command-line stringcommand
Additional switches associated with the command itself (if necessary)cmd options
This is the string which dictates the operation that should be executed by the target application itselfldquocommand-stringrdquo
The current namespace and command names are hpssacli and cmd respectively The cmdoptions parameter can be cmdopts or -q There is no need for an object type forhpssacli since the application operates on internal commands supplied in the command-string
HPSSACLI ESXCLI syntaxThe HPSSACLI utility is supported by the ESXCLI utilityUse the following command syntax for all commands esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocommand-stringrdquo
The command-string parameter supports same commands that are specified at the HPSSACLIinteractive command-line interface
Example 1 This example shows the information about all the SmartArray controller on the server
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpassword=rdquorootpasswordrdquo hpssacli cmd -q ldquocontroller all show status rdquo
The following output is displayed
Smart Array P212 in Slot 9 Controller Status OK
Smart Array P410i in Slot 0 (Embedded) Controller Status OK Cache Status OK BatteryCapacitor Status OK
Example 2 This example shows the detailed configuration information for the SmartArray controllerin slot 0
esxcli ndashserver=rdquoservername or IPrdquo ndashuser=rdquousernamerdquo ndashpasswordrdquorootpasswordrdquo hpssacli cmd -q ldquocontroller slot=0 show config detailrdquo
The following output is displayed
Smart Array P410i in Slot 0 (Embedded) Bus Interface PCI Slot 0
Serial Number 5001438013A25C90 Cache Serial Number PBCDF0CRH0J7SD RAID 6 (ADG) Status Disabled Controller Status OK Hardware Revision C
HPSSACLI utility 11
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
Firmware Version 370 Rebuild Priority Medium Expand Priority Medium Surface Scan Delay 15 secs Surface Scan Mode Idle Queue Depth Automatic Monitor and Performance Delay 60 min Elevator Sort Enabled Degraded Performance Optimization Disabled Inconsistency Repair Policy Disabled Wait for Cache Room Disabled Surface Analysis Inconsistency Notification Disabled Post Prompt Timeout 0 secs Cache Board Present True Cache Status OK Accelerator Ratio 25 Read 75 Write Drive Write Cache Disabled Total Cache Size 1024 MB Total Cache Memory Available 912 MB No-Battery Write Cache Disabled Cache Backup Power Source Capacitors BatteryCapacitor Count 1 BatteryCapacitor Status OK SATA NCQ Supported True
Array A Interface Type SAS Unused Space 0 MB Status OK Logical Drive 1 Size 1367 GB Fault Tolerance RAID 1 Heads 255 Sectors Per Track 32 Cylinders 35132 Strip Size 256 KB Full Stripe Size 256 KB Status OK Array Accelerator Enabled Unique Identifier 600508B1001CB65083D63C5E781ABF65 Disk Name vmhba2C0T0L1 Mount Points None Logical Drive Label A00D1AF35001438013A25C90F0BA Mirror Group 0 physicaldrive 1I11 (port 1Ibox 1bay 1 SAS 146 GB OK) Mirror Group 1 physicaldrive 1I12 (port 1Ibox 1bay 2 SAS 146 GB OK)
physicaldrive 1I11 Port 1I Box 1 Bay 1 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB
Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FJVL0000B145MFXB Model HP EG0146FAWHU Current Temperature (C) 36 Maximum Temperature (C) 46 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
12 Introduction
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
physicaldrive 1I12 Port 1I Box 1 Bay 2 Status OK Drive Type Data Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3EVBH0000B144Q7RD Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 49 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
unassigned
physicaldrive 1I13 Port 1I Box 1 Bay 3 Status OK Drive Type Unassigned Drive Interface Type SAS Size 146 GB Rotational Speed 10000 Firmware Revision HPDE Serial Number 6SD3FK4A0000B145J6JK Model HP EG0146FAWHU Current Temperature (C) 37 Maximum Temperature (C) 48 PHY Count 2 PHY Transfer Rate 60GBPS Unknown
These examples are not inclusive of all the capabilities of the HPSSACLI command Commandsand options for additional operations using the HPSSACLI such as creating a logical drive aredocumented in the Configuring Arrays on HP Smart Array Controllers Reference Guide
HPTESTEVENT utilityThe hptestevent utility allows an application to request so that the HP Insight ManagementWBEM Providers generate the Informational Test Indication with ProviderName ldquoHP Testrdquo andEventID 1 and the CPQ SNMP test trap with OID 13614123211281011003The HP Insight Management WBEM Providers must be installed enabled and running on the systemwhere this utility is executed The WBEM Providers must be configured to send indications to thelistener VMware SNMP traps must be enabled and configured to use WBEM indications as asource for SNMP trapsThe Informational Test Indication and the CPQ Test SNMP trap will be sent to any listener configuredto receive indications from the systemSee the HP Insight Management WBEM Provider Datasheets for information on the test indicationand the SNMP Data Migration Guide for information on the test SNMP trap on the BSC (BusinessSupport Center)
HPTESTEVENT command-line syntaxUse the following format at the command linehptestevent
HPTESTEVENT utility 13
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
There are no command options for the hptestevent utility
HPTESTEVENT ESXCLI syntaxThe hptestevent utility is supported by the ESXCLI utilityTo view the command usage options run the following command esxcli hptestevent
The following output is displayedUsage esxcli hptestevent cmd [cmd options]
Available Commands
execute execute the hptestevent command
To request a test indication and test SNMP trap to be generated run the following command esxcli hptestevent execute
The following output is displayedRequest successful Test event will be generated
HPTESTEVENT return codesThis section provides description about the return code after running the command
Table 8 hptestevent return codes
MeaningValue
Indicates success0
Request failed No test event will be generated1
Request failed must be root No test event will be generated2
Request failed couldnt determine if HP WBEM Providers are installed and running No testevent will be generated
3
Request failed HP WBEM Providers are not installed and running No test event will begenerated
4
HPTESTEVENT command-line examplesThis section provides sample examples to run the utility
Table 9 hptestevent command-line examples
DescriptionCommand-line
Run command directly on the ESXi hostopthptoolshptestevent
Use esxcli to run the commandesxcli hptestevent execute
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere55 and updates
The HPSSACLI application contains the ability to generate a diagnostic report of the system andits Smart Array storage configuration The following steps are required in order to obtain an ADUreport from a remote machine running vSphere 55 and updates
14 Introduction
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
1 Obtain and install the HP Smart Storage Administrator Diagnostics Utility (HP SSADU) CLI1 Browse to httpwwwhpcom2 Click on Support amp Drivers3 Select Drivers amp Software4 In the search box type HP Smart Storage Administrator Utility5 Select the operating system of the client machine that will be used to remotely access the
machine running vSphere 55 and updates6 Under the Software ndash System Management menu proceed to download the HP Smart
Storage Administrator Diagnostics Utility (HP SSADU) CLI by clicking on the link
NOTE The desired version is 9x or newer
7 Install the Windows component or Linux RPM package onto the client machine2 The location where the package has installed the included applications and then update your
system path to include this location3 The client machine used to access the remote vSphere 55 and updates machine must also
have the vSphere CLI esxcli command line tool installed and must be accessible throughthe system path Ensure that the client machine location is included in the path
4 Use the following tool and associated command-line parameters to perform the creation andretrieval of the reporthpssaduesxi --server=ltserver_ip_addressgt --user=ltusernamegt--password=ltpasswordgt lttargetfilezipgt
Example Usagehpssaduesxi --server=10121325 --user=root --password=root123myreportzip
The hpssaduesxi application uses the supplied parameters to remotely obtain the report from yourtarget vSphere 55 and updates machine and saves the data into the target zip file The zip filecan then be opened with any third-party zip application or with the unzip command under LinuxThe hpssaduesxi application also contains onboard help which can be obtained by typinghpssaduesxi with no parameters
Generating an ADU report (diagnostics) from within HPSSACLI for vSphere 55 and updates 15
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
2 Support and other resourcesThis chapter provides information about the contact details and reference documents
Contacting HPThis section provides information about the prerequisites to be verified before contacting HP andmechanism supported by the organization for sharing the feedback
Before you contact HPBe sure to have the following information available before you call contact HP
bull Technical support registration number (if applicable)
bull Product serial number
bull Product model name and number
bull Product identification number
bull Applicable error message
bull Add-on boards or hardware
bull Third-party hardware or software
bull Operating system type and revision level
HP contact informationFor the name of the nearest HP authorized reseller
bull See the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
For HP technical support
bull In the United States for contact options see the Contact HP United States webpage (httpwelcomehpcomcountryusencontact_ushtml) To contact HP by phone
Call 1-800-HP-INVENT (1-800-474-6836) This service is available 24 hours a day 7days a week For continuous quality improvement calls may be recorded or monitored
If you have purchased a Care Pack (service upgrade) call 1-800-633-3600 For moreinformation about Care Packs refer to the HP website (httpwwwhpcomhps)
In other locations see the Contact HP worldwide (in English) webpage (httpwelcomehpcomcountryusenwwcontacthtml)
Subscription serviceHP recommends that you register your product at the Subscribers Choice for Business websitehttpwwwhpcomcountryusencontact_ushtml After registering you will receive emailnotification of product enhancements new driver versions firmware updates and other productresources
Documentation feedbackHP welcomes your feedback To make comments and suggestions about product documentationsend a message to docsfeedbackhpcom Include the document title and manufacturing partnumber All submissions become the property of HP
16 Support and other resources
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
New and changed information in this editionbull Wording added for hponcfg and hpbootcfg to identify both tools support execution on
ProLiant Series 100 Gen 8bull Additional arguments for hponcfg command line
Related informationFollowing documents and websites provide related information
DocumentsFollowing documents are supported for the productbull HP VMware vSphere 51 Release Notes
bull HP VMware vSphere 51 and updates Getting Started Guide
WebsitesHP documents regarding VMware are available at the following locationhttpsh20392www2hpcomportalswdepotsearchProductsdo
Typographic conventionsThis document uses the following typographical conventions $ or A percent sign represents the C shell system prompt A dollar sign
represents the system prompt for the Bourne Korn and POSIXshells A number sign represents the superuser prompt
audit(5) A manpage The manpage name is audit and it is located inSection 5
Command A command name or qualified command phraseComputer output Text displayed by the computerCtrl+x A key sequence A sequence such as Ctrl+x indicates that you
must hold down the key labeled Ctrl while you press another keyor mouse button
ENVIRONMENT VARIABLE The name of an environment variable for example PATHERROR NAME The name of an error usually returned in the errno variableKey The name of a keyboard key Return and Enter both refer to the
same keyTerm The defined use of an important word or phraseUser input Commands and other text that you typeVariable The name of a placeholder in a command function or other
syntax display that you replace with an actual value[] The contents are optional in syntax If the contents are a list
separated by | you must choose one of the items The contents are required in syntax If the contents are a list
separated by | you must choose one of the items The preceding element can be repeated an arbitrary number of
timesIndicates the continuation of a code example
| Separates items in a list of choices
New and changed information in this edition 17
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
WARNING A warning calls attention to important information that if notunderstood or followed will result in personal injury ornonrecoverable system problems
CAUTION A caution calls attention to important information that if notunderstood or followed will result in data loss data corruptionor damage to hardware or software
IMPORTANT This alert provides essential information to explain a concept orto complete a task
NOTE A note contains additional information to emphasize or supplementimportant points of the main text
18 Support and other resources
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
Index
Ddocumentrelated documentation 17
Rrelated documentation 17
19
