﻿                      HP Smart Update Tools OnDemand Help

Version 1.0.1.0 ESXi

     ----------------------------------------------------------------------

   Copyright (c) 2015, 2016 Hewlett Packard Enterprise Development LP

   The information contained herein is subject to change without notice. The
   only warranties for Hewlett Packard Enterprise products and services are
   set forth in the express warranty statements accompanying such products
   and services. Nothing herein should be construed as constituting an
   additional warranty. Hewlett Packard Enterprise shall not be liable for
   technical or editorial errors or omissions contained herein.

   Confidential computer software. Valid license from Hewlett Packard
   Enterprise required for possession, use, or copying. Consistent with FAR
   12.211 and 12.212, Commercial Computer Software, Computer Software
   Documentation, and Technical Data for Commercial Items are licensed to the
   U.S. Government under vendor's standard commercial license.

     ----------------------------------------------------------------------

Overview

   This file is best viewed in a text browser, such as Notepad or vi.

   HP Smart Update Tools (HP SUT) for VMware ESXi is a service running on Red
   Hat Enterprise Linux (RHEL) 7.0 and provides an online, non-disruptive
   mechanism to stage components on the host server and deploy firmware and
   operating system drivers on the remote VMware ESXi server.

   When running as a service from the host server, HP SUT polls HPE OneView
   every five minutes for new requests and processes those requests based on
   the mode.

   For more information on using HP SUT, see the HP Smart Update Tools Users
   Guide on the HP SUT Information Library at:
   http://www.hpe.com/info/hpsut/docs.

   For information on using the Hewlett Packard Enterprise SDR, go to
   http://www.hpe.com/info/sdr/.

2 Using OnDemand mode

2.1 Command-line interface

   When running in OnDemand mode, HP SUT waits for a user command from the
   command-line to execute requests, show the help, and check the status of
   updates.

  2.1.1 Command-line syntax

   The general command-line syntax for HP SUT is as follows:

   hpsutesxi [/status]

      ---------------------------------------------------------------------   
    NOTE: On both Windows and Linux, use a slash or hyphen before each        
    argument.                                                                 
                                                                              
    For example:                                                              
                                                                              
    hpsutesxi /status                                                         
                                                                              
    hpsutesxi -status                                                         
      ---------------------------------------------------------------------   

  2.1.2 Command-line arguments

   HP SUT recognizes the following command-line arguments:

   +------------------------------------------------------------------------+
   | Option    | Description                                                |
   |-----------+------------------------------------------------------------|
   |           | Displays command line help information.                    |
   |           |                                                            |
   |           | Examples:                                                  |
   | /help     |                                                            |
   |           |   o hpsutesxi /help                                        |
   |           |                                                            |
   |           |   o hpsutesxi -help                                        |
   |-----------+------------------------------------------------------------|
   |           | Allows you to set HPE OneView and VMware vCenter Server    |
   |           | host address, username, and password.                      |
   |           |                                                            |
   |           | Setting HPE OneView details:                               |
   |           |                                                            |
   |           |   o hpsutesxi -set managementhost=ipaddress_1              |
   |           |     managementhostusername=Administrator                   |
   |           |     managementhostpassword=********                        |
   |           |                                                            |
   |           |   o hpsutesxi /set managementhost=ipaddress_2              |
   | /set      |     managementhostusername=Administrator                   |
   |           |     managementhostpassword=********                        |
   |           |                                                            |
   |           | Setting vCenter details                                    |
   |           |                                                            |
   |           |   o hpsutesxi -set vcenterhost=ipaddress_1                 |
   |           |     vcenterusername=administrator@vsphere.local            |
   |           |     vcenterpassword=*********                              |
   |           |                                                            |
   |           |   o hpsutesxi /set vcenterhost=ipaddress_2                 |
   |           |     vcenterusername=administrator@vsphere.local            |
   |           |     vcenterpassword=*********                              |
   |-----------+------------------------------------------------------------|
   |           | Changes the operating mode.                                |
   |           |                                                            |
   |           | Examples:                                                  |
   | /set mode |                                                            |
   |           |   o hpsutesxi -set mode=AutoDeploy|AutoDeployReboot        |
   |           |                                                            |
   |           |   o hpsutesxi /set mode=AutoDeploy|AutoDeployReboot        |
   |-----------+------------------------------------------------------------|
   |           | Starts the HP SUT ESXi service.                            |
   |           |                                                            |
   |           | Example:                                                   |
   | /start    |                                                            |
   |           |   o hpsutesxi -start                                       |
   |           |                                                            |
   |           |   o hpsutesxi /start                                       |
   |-----------+------------------------------------------------------------|
   |           | Provides the status of the HP SUT ESXi engine for ESXi     |
   |           | nodes for which a request was received.                    |
   |           |                                                            |
   |           |    -----------------------------------------------------   |
   |           |  NOTE: This command gives a summary of all nodes so the    |
   |           |  output may span many pages. You can use the Linux >       |
   |           |  command or the >> command to redirect the output to a     |
   | /status   |  file to see all of the details.                           |
   |           |    -----------------------------------------------------   |
   |           |                                                            |
   |           | Examples:                                                  |
   |           |                                                            |
   |           |   o hpsutesxi /status                                      |
   |           |                                                            |
   |           |   o hpsutesxi -status                                      |
   |-----------+------------------------------------------------------------|
   |           | Stops the HP SUT ESXi service, if it is running.           |
   |           |                                                            |
   |           | Examples:                                                  |
   | /stop     |                                                            |
   |           |   o hpsutesxi -stop                                        |
   |           |                                                            |
   |           |   o hpsutesxi /stop                                        |
   |-----------+------------------------------------------------------------|
   |           | Displays the HP SUT ESXi version.                          |
   |           |                                                            |
   |           | Examples:                                                  |
   | /version  |                                                            |
   |           |   o hpsutesxi /version                                     |
   |           |                                                            |
   |           |   o hpsutesxi -version                                     |
   +------------------------------------------------------------------------+

  2.1.3 Command-line examples

   Example 1

   This command-line input sets the HPE OneView IP address, username, and
   password.

   hpsutesxi -set managementhost=<string> managementhostusername=<string>
   managementhostpassword=<string>

   The format of the <string> parameter value is xxx.xxx.xxx.xxx for the
   parameter managementhost. The hpsut esxi binary parses or validates
   whether the string is in IP format and then logs the request into the
   database. The request is read by the HP SUT service from the database and
   upon validating the connectivity and the credentials, updates the HPE
   OneView host address in its cache.

   Results: The HPE OneView host address, username, and password are set
   successfully.

   Example 2

   This command-line input sets the vCenter IPaddress, username, and
   password.

   hpsutesxi -set vcenterhost=<string> vcenterusername=<string>
   vcenterpassword=<string>

   The format of the <string> parameter value is xxx.xxx.xxx.xxx for the
   parameter vcenterhost. The HP SUT binary parses or validates whether the
   string is in IP format and then logs the set request into the database.
   This request is read by the HP SUT service from the database and upon
   validating the connectivity and the credentials, updates the vCenter Host
   Address in its cache. All subsequent SOAP commands use this IP address to
   contact the vCenter.

   Results: The vCenter host address, username, and password are set
   successfully.

   Example 3

   This command-line input starts the HP SUT service.

   hpsutesxi -start

   Results: This command starts the HP SUT service. One of the following
   messages is displayed:

     o HP SUT service started successfully.

       Failed to start HP SUT service.

       HP SUT service is already running.

     o Failed to get details of the HP SUT service; HP SUT may not be
       registered as a service.

   Example 4

   This command-line input stops the HP SUT service if it is running.

   hpsutesxi -stop

   Results: This command stops the HP SUT service. One of the following
   messages is displayed:

     o HP SUT service is running; stopping it.

       HP SUT service stopped successfully.

       Failed to stop the HP SUT service.

       HP SUT is not running as a service.

       Failed to get details of the HP SUT service; HP SUT may not be
       registered as a service.

     o The HP SUT service is not running. Start the service using the
       hpsutesxi -start command.

       Command failed to execute.


Changing the HP SUT mode

   The format of the set mode command is: hpsutesxi -set mode
   =<autodeploy|autodeployreboot>

   The modes are:

   AutoDeploy - When a request is made by HPE OneView, HP SUT automatically
   stages components on the host server in a temporary location and then uses
   HP SUM to deploy the components to the nodes requested by HPE OneView.
   AutoDeploy is the default mode. ESXi can be called out of autodeploy mode
   and then a manually reboot of the ESXi target is required.

   AutoDeployReboot - When a request is made by HPE OneView, HP SUT
   automatically stages components, and if one or more component requires a
   reboot, reboots the server to activate them. "The HP SUT service is not
   running" displays if the service is not running.

Checking firmware deployment status

   The format of the status command is: hpsutesxi -status

   [root@localhost ~]# hpstuesxi - status
   Management Host.....................: HP OneView
   Management Host URL.................: http://xxx.xxx.xxx.xxx
   Management Host Status..............: ConnectionSuccess
   vCenter Server......................: xxx.xxx.xxx.xxx
   vCenter Server Status...............: ConnectionSuccess
   Mode of Operation...................: autodeployreboot
   Polling Interval in Minutes.........: 5
   Node Summary........... ............: 1 number of nodes, 1 Activated

   Host ID: xx.xxx.xxx.xx

   Deploy Status...........................: Activated
   Staging Directory.......................: /opt/hp/hpsutesxi/SPPname
   Baseline Version........................: 2015.10.0
   Force Deploy............................: false
   User Action Needed......................: None. Activation is complete and node is updated with the current baseline

   Inventory Report

   ComponentCount.......................: 7
   HasFailedDependencies................: No
   HasOmittedComponents.................: No
   NodeStatus...........................: Unknown
   RebootRequiredAfterDeploy............: Yes
   SoftwareAndDriverComponentCount......: 0
   FirmwareComponentCount...............: 7

Support and other resources

5.1 Documentation feedback

   Hewlett Packard Enterprise is committed to providing documentation that
   meets your needs. To help us improve the documentation, send any errors,
   suggestions, or comments to Documentation Feedback
   (<docsfeedback@hpe.com>). When submitting your feedback, include the
   document title, part number, edition, and publication date located on the
   front cover of the document. For online help content, include the product
   name, product version, help edition, and publication date located on the
   legal notices page.
