PowerProtect Data Manager 19.14 SAP HANA User Guide

Update the application agent in the PowerProtect Data Manager UI

Learn how to perform a precheck operation and update the application agent software on one or more hosts in the PowerProtect Data Manager UI.

To perform a precheck:

1. From the left navigation pane in the PowerProtect Data Manager UI, select Infrastructure > Application Agents.
   The Application Agents window opens.
2. Select the check box next to each application agent host to be included in the precheck.
   When the application agent versions on the selected hosts are 19.10 or later and the versions are earlier than the current PowerProtect Data Manager version, the More Actions button becomes enabled.
3. Click More Actions > Precheck Update.
   The Precheck Update window opens.
4. On the Schedule Precheck page:
   1. In the Name text box, type a name for the precheck operation.
   2. Select one of the following options:
      • Precheck now—Performs the precheck immediately.
      • Precheck later—Schedules the precheck to occur at a later time. If you select this option, specify the date and time to perform the precheck.
   3. Click Next.
5. On the Summary page, review the information for the selected application agent hosts, and then click OK.

   The precheck verifies that the application agent hosts meet the minimum update requirements, including system memory, disk space, and version requirements. If the precheck passes, PowerProtect Data Manager downloads the update software package on each application agent host.

   You can monitor the progress of the precheck operation in the System Jobs window.

To perform an update:

6. From the left navigation pane in the PowerProtect Data Manager UI, select Infrastructure > Application Agents.
   The Application Agents window opens.
7. Select the check box next to each application agent host to be included in the update.
   NOTE:In a cluster environment, select each host of the cluster; otherwise, any unselected hosts are automatically selected for the update. Ensure that each host of a cluster has the same application agent version.
   When the application agent versions on the selected hosts are 19.10 or later and the versions are earlier than the current PowerProtect Data Manager version, the More Actions button becomes enabled.
8. Click More Actions > Configure Update.
   The Configure Update window opens.
9. On the Schedule Updates page:
   1. In the Name text box, type a name for the update operation.
   2. Select one of the following options:
      • Update now—Performs the update immediately.
      • Update later—Schedules the update to occur at a later time. If you select this option, specify the date and time to perform the update.
   3. Click Next.
10. On the Summary page, review the information for the selected application agent hosts, and then click OK.

    On each selected host, the update performs a precheck, places the host in maintenance mode, updates the application agent, and then returns the host to normal mode.

    You can monitor the progress of the update operation in the System Jobs window.

    When the update is complete, the update status of each host changes to Up to date in the Application Agents window.

    NOTE:A reboot is not required after the completion of the software update.

    If the update fails:

    • An error is displayed, and you must manually return the hosts to normal mode.
    • Check the agent service logs for details on how to manually restore the host system.
    • Check the ADM logs for more information.

    • For detailed steps to downgrade to a previous version of the application agent, run the following command:

      ./pushupdate.sh -r -n