Exadata Fleet Update Actions

The Actions for a Maintenance Cycle are run sequentially in the same order as follows: Precheck (Stage) > Stage software > Precheck (Apply) > Apply update.

You can run the Apply action at a scheduled date and time but you cannot run it until the Stage action has been completed successfully. A Precheck is available to run for the Stage and Apply actions respectively. You can manually run a precheck. However, prechecks are run automatically as part of the Stage and Apply actions. You can configure Stage and Apply actions to run at a scheduled date and time or run them on demand.

1. Open the navigation menu. Under Oracle AI Database, click Exadata Fleet Update.

   Under Exadata Fleet Update, Collections is selected by default.

2. Click the name of the collection that you want to edit.

   Collection details page is displayed.

3. Click the Maintenance cycles tab.
4. In the list of maintenance cycles, click the name of the maintenance cycle to view details, or click the Actions icon (three dots) for a target, and then click View Details.

   Maintenance cycle details page is displayed.

5. Click the Actions tab.
6. From the Actions menu, select Precheck.

   Precheck prior to staging software dialog is displayed.

   In the Precheck prior to staging software dialog, do the following:

   1. Schedule precheck: Select this option and set the precheck start date and time and then click Schedule.
   2. Run precheck now: Select this option to run the precheck on demand and then click Run Precheck.

      While the precheck is being run, the statuses of both the resources, Maintenance cycle and Action change to In Progress.

      If the precheck fails to run and the issue has not yet been resolved, then the status of the Maintenance cycle changes to Needs Attention.

      The Actions section provides details about the Scheduled, In Progress, Succeeded, and Failed Actions.

      For a failed action, view the errors on the action page, and then retry the action after resolving the errors, or remove the targets from the collection.

      1. To view error details, click the name of the failed Action.

         Action details page is displayed.

         Under Resources, Jobs is selected by default.

         The Jobs section provides details about the Scheduled, In Progress, Succeeded, and Failed Jobs.

      2. To view error details, click the Actions icon (three dots) for a target, and then click View errors.

         View errors page is displayed.

      3. Fix the errors.
      4. To retry failed actions, on the Maintenance details page, click the Actions icon (three dots) for an Action, and then click Run Precheck Now.

         The precheck run succeeds.

7. On the Maintenance cycle details page, click Stage software.

   Stage software dialog is displayed.

   In the Stage software dialog, do the following:

   1. Schedule stage: Select this option and set the Stage software start date and time and then click Schedule.
   2. Stage now: Select this option to run the Stage software on demand and then click Stage now.

      While the Stage software is being run, the statuses of both the resources, Maintenance cycle and Action change to In Progress.

      If the Stage software fails to run and the issue has not yet been resolved, then the status of the Maintenance cycle changes to Needs Attention.

      The Actions section provides details about the Scheduled, In Progress, Succeeded, and Failed Actions.

      For a failed action, view the errors on the action page, and then retry the action after resolving the errors, or remove the targets from the collection.

      1. To view error details, click the name of the failed Action.

         Action details page is displayed.

         Under Resources, Jobs is selected by default.

         The Jobs section provides details about the Scheduled, In Progress, Succeeded, and Failed Jobs.

      2. To view error details, click the Actions icon (three dots) for a target, and then click View errors.

         View errors page is displayed.

      3. Fix the errors.
      4. To retry failed actions, on the Maintenance details page, click Stage software.

         Retry stage software page is displayed.

         If you click to retry a failed target, then the default is to run the action now. Otherwise, the default is to schedule the action.

      5. Click Retry stage software.

         The Stage software run succeeds.

8. On the Maintenance cycle details page, click Precheck.

   Precheck prior to applying software updates dialog is displayed.

   In the Precheck prior to applying software updates dialog, do the following:

   1. Schedule precheck: Select this option and set the precheck start date and time and then click Schedule.
   2. Run precheck now: Select this option to run the precheck on demand and then click Run Precheck.

      While the precheck is being run, the statuses of both the resources, Maintenance cycle and Action change to In Progress.

      The precheck run succeeds.

9. On the Maintenance cycle details page, click Apply update.

   Apply software updates dialog is displayed.

   In the Apply software updates dialog, do the following:

   1. Schedule update: Select this option and set the Apply update start date and time and then click Schedule.
   2. Apply update now: Select this option to run the Apply update on demand and then click Apply update now.

      While the Apply update is being run, the statuses of both the resources, Maintenance cycle and Action change to In Progress.

      The Actions section provides details about the Scheduled, In Progress, Succeeded, Failed, and Canceled Actions.

      Note
      
      

      If the Stage software Action does not complete successfully at the scheduled start time for the Apply update Action, then the Apply update Action is canceled automatically.

1. Open the navigation menu. Under Oracle AI Database, click Exadata Fleet Update.

   Under Exadata Fleet Update, Collections is selected by default.

2. Click the name of the collection that you want to edit.

   Collection details page is displayed.

3. Click Maintenance cycles tab.
4. In the list of maintenance cycles, click the name of the maintenance cycle to view details, or click the Actions icon (three dots) for a target, and then click View Details.

   Maintenance cycle details page is displayed.

5. Click the Actions tab.
6. Click an Action that is In progress, for example, Stage software.

   Action details page is displayed.

7. For a Failed job, click the Actions icon (three dots) for a target, and then click Retry.

   The Retry option is available only when a Stage or Apply Action is running.

   The status of the Failed job changes to In Progress.

   After completing successfully, the status changes to Succeeded.

1. Open the navigation menu. Under Oracle AI Database, click Exadata Fleet Update.

   Under Exadata Fleet Update, Collections is selected by default.

2. Click the name of the maintenance cycle for which you want to download failed job logs.

   Maintenance cycle details page is displayed.

3. Click the Actions tab.
4. In the Actions section, click the name of the Action for which you want to view or download logs.

   Action details page is displayed.

   Jobs tab displays the list of jobs associated with the selected Action.

5. From the list of jobs, select one, click the Actions icon (three dots), and then click View log.

   View log page is displayed.

   The log is refreshed every two minutes automatically.

6. Click Refresh to refresh on-demand.
7. Click Download log to download the log.

1. Open the navigation menu. Under Oracle AI Database, click Exadata Fleet Update.

   Under Exadata Fleet Update, Collections is selected by default.

2. Click the name of the maintenance cycle for which you want to download failed job logs.

   Maintenance cycle details page is displayed.

3. Click the Actions tab.
4. In the Actions section, find the action that has the status Failed.
5. Click the Actions icon (three dots), and then click Download failed job logs.
   (or)

   1. Click the name of the Action.

      Action Details page is displayed.

   2. From the Actions menu, select Download failed job logs.

1. To view details, click the name of the Action

   Action details page is displayed.

2. Click the Jobs tab.

   The Jobs tab provides details about the Scheduled, In Progress, Succeeded, and Failed Jobs.

3. To retry failed job, click the Actions icon (three dots) for a Job, and then click Retry.

   The failed job returns to the In progress state.

4. Click the Actions icon (three dots) for a Job, and then click View log.

   View log page is displayed.

5. If there are still failed jobs, then click Retry failed targets.

   Retry apply update dialog is displayed.

   By default, Apply update now is selected if you retry failed targets.

6. Click Retry apply update.

   A notification appears indicating that the new action is in progress.

7. Click the link to view details.

   Apply update (retry) page is displayed.

   If one of the jobs fails, then you can choose to rollback and remove the target from the collection.

8. Click the Actions icon (three dots) for a failed Job, and then click Rollback and remove target from collection.

   Rollback and remove target dialog is displayed.

9. Review the information and then click Rollback and remove target.

   A notification appears indicating that the Rollback and remove action is in progress.

10. The statuses of both the resources, Maintenance cycle and Action change to In Progress.

    The rollback and remove action succeeds.

11. Click the name of the Action to view details.

    Action details page is displayed.

    The status of the resource, Maintenance cycle changes to Succeeded.

1. To view details, click the name of the Action

   Action details page is displayed.

2. Click the Jobs tab.

   The Jobs section provides details about the Scheduled, In Progress, Succeeded, and Failed Jobs.

3. Click the Actions icon (three dots) for a failed Job, then click Rollback and remove target from collection.

   Rollback and remove target dialog is displayed.

4. Review the information and then click Rollback and remove target.

   A notification appears indicating that the Rollback and remove action is in progress.

5. The statuses of both resources, Maintenance cycle and Action change to In Progress.

   The rollback and remove action succeeds.

6. Click the name of the Action to view details.

   Action details page is displayed.

   The status of the resource, Maintenance cycle changes to Succeeded.

1. Open the navigation menu. Under Oracle AI Database, click Exadata Fleet Update.

   Under Exadata Fleet Update, Collections is selected by default.

2. Click the name of the Collection for which you want to roll back the applied updates.

   The Collection details page is displayed.

3. In the Last completed maintenance cycle section, click the link next to Maintenance cycle.

   The Maintenance Cycle details page is displayed.

4. From the More Actions menu, select Rollback.
5. In the Rollback dialog, enter the name of the Collection.
6. Click Rollback.

   The rollback operation is displayed as In progress in the Actions section of the Maintenance Cycle details page.

7. Monitor the rollback operation and take the appropriate action based on its status:
   • Needs attention: The rollback has partially succeeded because one or more targets don't have old DB homes and will be skipped. Hover over the information icon to view details about the affected targets.
     Note
     
     After the rollback cycle precheck completes successfully, you have one hour to confirm the rollback.
     1. Click the Actions icon (three dots), and then click Confirm Rollback.

        The Confirm rollback dialog displays the list of skipped targets.

     2. Click Proceed rollback to continue the rollback, or Cancel rollback to cancel it.

        If the rollback succeeds, a confirmation banner is displayed and Last completed rollback time in the General information section is updated with the UTC date and time.

   • Failed: The rollback operation has failed for one or more targets.
     1. Click the name of the failed action.

        The Action details page displays the job details. You can select and retry individual failed targets while the action is In progress.

     2. Click the Actions icon (three dots), and then click Retry.
   • Succeeded: The rollback has completed successfully. Verify that the targets have returned to the required patch level.

For example, consider a Maintenance Cycle that updates an environment from Patch 19.21 to Patch 19.23:

1. Apply the update: The Maintenance Cycle updates the environment from Patch 19.21 to Patch 19.23. After Apply Update completes successfully, the Cleanup action becomes available. If the updated environment is operating as expected, you can run cleanup to remove residual data associated with Patch 19.21.
2. Initiate a rollback: If you encounter issues or incompatibilities with Patch 19.23, initiate a rollback to return the environment to Patch 19.21. During the rollback, Cleanup is disabled to preserve the data required to restore the previous patch level.
3. Complete the rollback and cleanup: After the rollback completes, the environment is restored to Patch 19.21. Cleanup remains unavailable for the rolled-back update. Data or environments associated with Patch 19.23 aren't cleaned up automatically and must be removed manually, as appropriate, to avoid unnecessary resource consumption or dependencies.

The Cleanup action:

• Retrieves the list of source Oracle Database Homes in the collection for the maintenance cycle.
• Deletes a Oracle Database Home only if it’s empty, meaning no databases are using it.
  • If a Oracle Database Home is being used by one or more databases, marks its related jobs as "NEEDS_ATTENTION."
  • If all Oracle Database Homes are in use, none can be deleted. The action will end as "NEEDS_ATTENTION," allowing the user to free the Oracle Database Homes and retry.

For more information, see Create Oracle Database Homes on an Exadata Cloud Infrastructure System.

The Cleanup action becomes available only after the Apply Update completes successfully. You can either schedule the cleanup operation or run it immediately.

• Schedule cleanup: Select this option and set the Cleanup start date and time and then click Schedule.
• Cleanup now: Select this option to run the Cleanup on demand and then click Cleanup now.