﻿                      Smart Update Tools OnDemand Help

Version 2.0.0.0 ESXi

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

   Copyright (c) 2015, 2017 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.

   Smart Update Tools (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, SUT polls HPE OneView
   every five minutes for new requests and processes those requests based on
   the mode.

   For more information on using SUT, see the Smart Update Tools Users
   Guide on the SUT Information Library at:
   http://www.hpe.com/info/sut-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, 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 SUT is as follows:

   sutesxi [/status]

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

  2.1.2 Command-line arguments

   SUT recognizes the following command-line arguments:

   +------------------------------------------------------------------------+
   | Option    | Description                                                |
   |-----------+------------------------------------------------------------|
   |           | Displays command line help information.                    |
   |           |                                                            |
   |           | Examples:                                                  |
   | /help     |                                                            |
   |           |   o sutesxi /help                                          |
   |           |                                                            |
   |           |   o sutesxi -help                                          |
   |-----------+------------------------------------------------------------|
   |           | Allows you to set HPE OneView and VMware vCenter Server    |
   |           | host address, username, and password.                      |
   |           |                                                            |
   |           | Setting HPE OneView details:                               |
   |           |                                                            |
   |           |   o sutesxi -set managementhost=ipaddress_1                |
   |           |     managementhostusername=Administrator                   |
   |           |     managementhostpassword=********                        |
   |           |                                                            |
   |           |   o sutesxi /set managementhost=ipaddress_2                |
   | /set      |     managementhostusername=Administrator                   |
   |           |     managementhostpassword=********                        |
   |           |                                                            |
   |           | Setting vCenter details                                    |
   |           |                                                            |
   |           |   o sutesxi -set vcenterhost=ipaddress_1                   |
   |           |     vcenterusername=administrator@vsphere.local            |
   |           |     vcenterpassword=*********                              |
   |           |                                                            |
   |           |   o sutesxi /set vcenterhost=ipaddress_2                   |
   |           |     vcenterusername=administrator@vsphere.local            |
   |           |     vcenterpassword=*********                              |
   |-----------+------------------------------------------------------------|
   |           | Changes the operating mode.                                |
   |           |                                                            |
   |           | Examples:                                                  |
   | /set mode |                                                            |
   |           |   o sutesxi -set mode=AutoDeploy|AutoDeployReboot          |
   |           |                                                            |
   |           |   o sutesxi /set mode=AutoDeploy|AutoDeployReboot          |
   |-----------+------------------------------------------------------------|
   |           | Starts the SUT ESXi service.                               |
   |           |                                                            |
   |           | Example:                                                   |
   | /start    |                                                            |
   |           |   o sutesxi -start                                         |
   |           |                                                            |
   |           |   o sutesxi /start                                         |
   |-----------+------------------------------------------------------------|
   |           | Provides the status of the 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 sutesxi /status                                        |
   |           |                                                            |
   |           |   o sutesxi -status                                        |
   |-----------+------------------------------------------------------------|
   |           | Stops the SUT ESXi service, if it is running.              |
   |           |                                                            |
   |           | Examples:                                                  |
   | /stop     |                                                            |
   |           |   o sutesxi -stop                                          |
   |           |                                                            |
   |           |   o sutesxi /stop                                          |
   |-----------+------------------------------------------------------------|
   |           | Displays the SUT ESXi version.                             |
   |           |                                                            |
   |           | Examples:                                                  |
   | /version  |                                                            |
   |           |   o sutesxi /version                                       |
   |           |                                                            |
   |           |   o sutesxi -version                                       |
   +------------------------------------------------------------------------+

  2.1.3 Command-line examples

   Example 1

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

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

   The format of the <string> parameter value is xxx.xxx.xxx.xxx for the
   parameter managementhost. The sut 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 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.

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

   The format of the <string> parameter value is xxx.xxx.xxx.xxx for the
   parameter vcenterhost. The 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 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 SUT service.

   sutesxi -start

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

     o SUT service started successfully.

       Failed to start SUT service.

       SUT service is already running.

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

   Example 4

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

   sutesxi -stop

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

     o SUT service is running; stopping it.

       SUT service stopped successfully.

       Failed to stop the SUT service.

       SUT is not running as a service.

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

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

       Command failed to execute.


Changing the SUT mode

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

   The modes are:

   AutoDeploy - When a request is made by HPE OneView, SUT automatically
   stages components on the host server in a temporary location and then uses
   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, SUT
   automatically stages components, and if one or more component requires a
   reboot, reboots the server to activate them. "The SUT service is not
   running" displays if the service is not running.

Checking firmware deployment status

   The format of the status command is: sutesxi -status

   [root@localhost ~]# sutesxi - status
   Management Host.....................: HPE 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.......................: /temp/sutesxi/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

