updatecomp apply

This command updates firmware on a specific device.

Syntax

updatecompapply  -h

updatecomp apply -a apply [-m <activate_mode>] [-l <device_list>
                          [-c <CMMs>] [-s <servers>] [-w <switches>] [-t <storage_systems>] 

updatecomp apply -a cancelapply [-l <device_list>
                [-c <CMMs>] [-s <servers>] [-w <switches>] [-t <storage_systems>] 

updatecomp apply -a power [-c <cmms>] [-s <servers>] [-w <switches>]
Note: You must specify one or more of the following parameters: –c, –s, –t, and –w.

Options

{-h | --help}
Displays the syntax and brief usage information for this command.
{–a | --action} <action>
Specifies the action to take. This can be one of the following values
  • apply. (default) Applies the associated firmware to the specified device.

    The following set of properties must be specified for each device. Each property is separated by a semicolon, and each set of properties is separated by a comma.
    • UUID of the storage system

    • Fix (firmware-update) ID of the target package to be applied to the component.

    • Component name

    For example:
    AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA,lnvgy_fw_storage_1.1.1,Controller A
  • cancelApply. Cancels the firmware update request on the specified device.

    The following set of properties must be specified for each device. Each property is separated by a semicolon, and each set of properties is separated by a comma.
    • UUID of the storage system

    • Fix (firmware-update) ID of the target package to be applied to the component.

    • Component name

    For example:
    AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA,lnvgy_fw_storage_1.1.1,Controller A
  • power. Performs a power operation on the specified device.

    The following set of properties must be specified for each device. Each property is separated by a semicolon, and each set of properties is separated by a comma.
    • UUID of the device

    • The power state. This can be one of the following values, depending on the type of device:

      • CMM: reset

      • Server: powerOn, powerOff, powerCycleSoft, powerCycleSoftGraceful, powerOffHardGraceful

      • Switch: powerOn, powerOff, powerCycleSoft

      • Storage: powerOn, powerOff, powerCycleSoft

    For example:
    AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA;powerOn,BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB;powerOn
{-c | --cmm} <CMMs>
Specifies a set of properties for one or more CMMs.
{-l | --device_list} <device_list>
Specifies a list of devices and components, in the following JSON format.

To obtain the component names and firmware-update IDs, use the updaterepo query method.

Parameters Required / Optional Type Description
DeviceList Required Array of objects List of devices
  CMMList Optional Array of objects List of CMMs
    Components Required Array of strings List of components in the CMM
      Component Required String Component name
      Fixed Optional String Firmware-update ID of the target package to be applied to the component. Specify if this field if the update is not driven by the firmware-compliance policy. Do not specify if the update is driven by the policy.
    UUID Required String UUID of the chassis CMM
  ServerList Optional Array of objects List of servers
    Components Required Array of objects List of components in the server
      Component Required String Component name
      Fixid Optional String Firmware-update ID of the target package to be applied to the component. Specify if this field if the update is not driven by the firmware-compliance policy. Do not specify if the update is driven by the policy.
    UUID Required String UUID of the server
  StorageList Optional Array of objects List of Lenovo Storage devices
    Components Required Array of objects List of components in the storage device
      Component Required String Component name
      Fixid Optional String Firmware-update ID of the target package to be applied to the component. Specify if this field if the update is not driven by the firmware-compliance policy. Do not specify if the update is driven by the policy.
    UUID Required String WWNN of the storage device
  SwitchList Optional Array of objects List of switches
    Components Required Array of objects List of components in the switch
      Component Required String Component name
      Fixid Optional String Firmware-update ID of the target package to be applied to the component. Specify if this field if the update is not driven by the firmware-compliance policy. Do not specify if the update is driven by the policy.
    UUID Required String UUID of the switch

The following example applies firmware updates to multiple devices and components.

{   
   "DeviceList": [{
      "ServerList": [{
         "UUID": "8BFBADCC33CB11E499F740F2E9903640",
         "Components": [{
            "Fixid": "lnvgy_fw_imm2_tcoo17g-3.00_anyos_noarch",
            "Component": "IMM2 (Backup)"
         },
         {
            "Fixid": "lnvgy_fw_imm2_tcoo17g-3.00_anyos_noarch",
            "Component": "IMM2 (Primary)"
         }]
      }]
   },
   {
      "CMMList": [{
         "UUID": "8BFBADCC33CB11E499F740F2E9903640",
         "Components": [{
            "Fixid": "lnvgy_fw_imm2_tcoo17g-3.00_anyos_noarch",
            "Component": "CMM”)"
         }]
      }]
   },
   {
      "SwitchList": [{
         "UUID": "8BFBADCC33CB11E499F740F2E9903640",
         "Components": [{
            "Fixid": "lnvgy_fw_scsw_en4093r-8.3.9.0_anyons_noarch",
            "Component": "Main Application"
         }]
      }]
   },
   {
      "StorageList": [{
         "UUID": "8BFBADCC33CB11E499F740F2E9903640",
         "Components": [{
            "Fixid": "lnvgy_fw_storage_1.1.1",
            "Component": "Controller a"
         }]
      }]
   }]
}
{-m | --mode} <activate_mode>
Indicates when to activate the update. This can be one of the following values.
  • immediate. (default) During the update process, the target device might be automatically restarted multiple times until the entire process is complete. Ensure that you quiesce all applications on the target device before you proceed.
  • delayed. Some but not all update operations are performed. The target device must be restarted manually to continue the update process. Additional restarts are then performed automatically until the update operation completes. This rule is supported only for servers and rack switches.
  • prioritized. Firmware updates on the baseboard management controller are activated immediately; all other firmware updates are firmware updates are activated the next time the device is restarted. Additional restarts are then performed until the update operation completes. This rule is supported only for servers.
{-s | --server} <servers>
Specifies a set of properties for one or more servers.
{-t | --storage} <storage_systems>
Specifies a set of properties for one or more storage devices.
{-w | --switch} <switches>
Specifies a set of properties for one or more switches.
{-v | --view} <filter>
Identifies the view to use for the returned data. If a filter is not specified, the default view is used.

You can also create custom views (see Creating custom views).

Examples

The following example applies a firmware update on a storage device and immediate activates the update.
connect --url https://192.0.2.0 --user ADMIN --noverify
updatecomp apply -a immediate -t AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA; lnvgy_fw_storage_1.1.1;Controller A
The following example powers off a server and a storage system.
connect --url https://192.0.2.0 --user ADMIN --noverify
updatecomp apply -a power –s AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA;powerOff –t BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB;powerOff

Related links