Skip to main content

Applying the hotfix

Contributors netapp-lhalbert

The hotfix is first applied automatically to the primary Admin Node. Then, you must approve the application of the hotfix to other grid nodes until all nodes are running the same software version. You can customize the approval sequence by selecting to approve individual grid nodes, groups of grid nodes, or all grid nodes.

What you'll need
  • You have reviewed all of the considerations and completed all of the steps in “Hotfix planning and preparation.”

  • You must have the provisioning passphrase.

  • You must have Root Access or the Maintenance permission.

  • You can delay applying a hotfix to a node, but the hotfix process is not complete until you apply the hotfix to all nodes.

  • You cannot perform a StorageGRID software upgrade or a SANtricity OS upgrade until you have completed the hotfix process.

Steps
  1. Sign in to the Grid Manager using a supported browser.

  2. Select Maintenance > System > Software Update.

    The Software Update page appears.

    Software Update Landing Page
  3. Select StorageGRID Hotfix.

    The StorageGRID Hotfix page appears.

    Hotfix Choose File
  4. Select the hotfix file you downloaded from the NetApp support site.

    1. Select Browse.

    2. Locate and select the file.

      hotfix-install-version

    3. Select Open.

      The file is uploaded. When the upload is finished, the file name is shown in the Details field.

      Note Do not change the file name since it is part of the verification process.
      Hotfix File Validated
  5. Enter the provisioning passphrase in the text box.

    The Start button becomes enabled.

    Hotfix Start Enabled
  6. Select Start.

    A warning appears stating that your browser's connection might be lost temporarily as services on the primary Admin Node are restarted.

    screenshot showing Connection will be temporarily lost dialog box
  7. Select OK to start applying the hotfix to the primary Admin Node.

    When the hotfix starts:

    1. The hotfix validations are run.

      Note If any errors are reported, resolve them, re-upload the hotfix file, and select Start again.
    2. The hotfix installation progress table appears. This table shows all nodes in your grid and the current stage of the hotfix installation for each node. The nodes in the table are grouped by type:

      • Admin Nodes

      • Gateway Nodes

      • Storage Nodes

      • Archive Nodes

      Note The progress bar reaches completion, and then the primary Admin Node is shown first with stage “Complete.”
    Hotfix Progress Table
  8. Optionally, sort the lists of nodes in each grouping in ascending or descending order by Site, Name, Progress, Stage, or Details. Or, enter a term in the Search box to search for specific nodes.

  9. Approve the grid nodes that are ready to be updated. Approved nodes of the same type are upgraded one at a time.

    Important Do not approve the hotfix for a node unless you are sure the node is ready to be updated.When the hotfix is applied to a grid node, some services on that node might be restarted. These operations might cause service interruptions for clients that are communicating with the node.
    • Select one or more Approve buttons to add one or more individual nodes to the hotfix queue.

    • Select the Approve All button within each grouping to add all nodes of the same type to the hotfix queue. If you have entered search criteria in the Search box, the Approve All button applies to all the nodes selected by the search criteria.

      Note The Approve All button at the top of the page approves all nodes listed on the page, while the Approve All button at the top of a table grouping only approves all nodes in that group. If the order in which nodes are upgraded is important, approve nodes or groups of nodes one at a time and wait until the upgrade is complete on each node before approving the next node(s).
    • Select the top-level Approve All button at the top of the page to add all nodes in the grid to the hotfix queue.

      Note You must complete the StorageGRID hotfix before you can start a different software update. If you are unable to complete the hotfix, contact technical support.
  10. If you need to remove a node or all nodes from the hotfix queue, select Remove or Remove All.

    As shown in the example, when the Stage progresses beyond “Queued,” the Remove button is hidden and you can no longer remove the node from the hotfix process.

    Hotfix progress with remove button
  11. Wait while the hotfix is applied to each approved grid node.

    When the hotfix has been successfully installed on all nodes, the Hotfix Installation Progress table closes. A green banner shows the date and time the hotfix was completed.

  12. If the hotfix could not be applied to any nodes, review the error for each node, resolve the issue, and repeat these steps.

    The procedure is not complete until the hotfix is successfully applied to all nodes. You can safely retry the hotfix process as many times as required until it is complete.

Related information

Hotfix planning and preparation