Exadata Fleet Update Collections

Learn to create and manage Exadata Fleet Update collections.

Create a Collection

To create a collection, be prepared to provide values for the fields required for configuring the collection.

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

    Under Exadata Fleet Update, Collections is selected by default.

  2. Click Create Collection.

    Create collection page is displayed.

    In the Create collection page, provide the requested information:

    • Enter attributes:
      • Collection name: Enter a descriptive name.
      • Compartment: The compartment for the collection. Targets may be added from multiple compartments to a collection.
      • Collection type:

        You have the following options. Select the appropriate software update type to apply a ExaDB Stack update:

        • Database software update

          Apply patches or updates to Oracle Database binaries only.

        • Grid Infrastructure software update

          Apply updates specifically to Oracle Grid Infrastructure (GI), including clusterware and ASM.

        • Guest VM OS software update

          Apply operating system updates for Exadata Virtual Machine Clusters.

        • Grid Infrastructure and Guest VM OS software update (ExaDB Stack Update)

          Apply a coordinated, combined software update across both Grid Infrastructure and Guest VM OS components.

          This option enables a ExaDB Stack Update, minimizing disruptions by combining update workflows and restarting the database instance only once.

          For more information, see Configuring Continuous Availability for Applications.

      • Cloud service: Select Oracle Exadata Database Service on Cloud@Customer (ExaDB-C@C) or Oracle Exadata Database Service on Dedicated Infrastructure (ExaDB-D).
      • Current major version: Select the current major version. Target in a collection must be of the same version, but can be of different patch levels.
      • Search criteria:

        Click Edit search criteria.

        Search for targets that you would like to add to the collection. Search results will only include targets that match all criteria. Fields left empty will return all values

        • Compartment: Select a compartment.

          Compartment is a required field. Other fields are disabled until a value is entered for the Compartment field.

          Click Another compartment to add more compartments to expand your search.

        • The available choices vary depending on your Collection type (Database, Grid Infrastructure, Guest VM OS software, or a combination of Grid Infrastructure and Guest VM OS software).
          • Database:
            • Database release update: Select one or more database release updates.
            • Custom database software image: Select one or more custom database software images.
            • Exadata infrastructure: Select one or more Exadata infrastructures.
            • VM cluster: Select one or more VM Clusters.

              This field is disabled until you select an Exadata infrastructure. When enabled, this field displays only the VM Clusters that belong to the selected compartments and infrastructures.

            • Database Home: Enter a comma-delimited list of database home names. Use asterisk (*) for wildcard searches.
            • Database name: Enter a comma-delimited list of database names. Use asterisk (*) for wildcard searches.
            • Database unique name: Enter a comma-delimited list of database unique names. Use asterisk (*) for wildcard searches.
            • Collection name: Select one or more collection names.
            • Include targets already in an active maintenance cycle in another collection: Select this checkbox if you want to add targets that are already in an active maintenance cycle in another collection.

              Note:

              Each target can only belong to one active maintenance cycle at a time. Adding targets that are already in an active maintenance cycle in another collection will not allow a maintenance cycle to be created until the other maintenance cycle(s) have been completed or these targets have been removed from the collection.

            • Tags: (Optional) You can choose to apply tags. If you have permission to create a resource, then you also have permission to apply free-form tags to that resource. To apply a defined tag, you must have permission to use the tag namespace. For more information about tagging, see Resource Tags. If you are not sure if you should apply tags, then skip this option (you can apply tags later) or ask your administrator.

              Note:

              If you attempt to clear a compartment, then the system displays the Clear associated criteria dialog box to clear the associated criteria first. Similarly, if you attempt to clear an Exadata infrastructure, then the system displays the Clear associated criteria dialog box to clear the associated criteria first.

            • Click Apply.
          • Grid Infrastructure:
            • Grid Infrastructure release update: Select one or more Grid Infrastructure release updates.
            • Custom Grid Infrastructure software image: Select one or more custom Grid Infrastructure software images.

              For more information, see Create a Custom Oracle Grid Infrastructure Software Image.

            • Exadata infrastructure: Select one or more Exadata infrastructures.
            • VM cluster: Select one or more VM Clusters.

              This field is disabled until you select an Exadata infrastructure. When enabled, this field displays only the VM Clusters that belong to the selected compartments and infrastructures.

            • Collection name: Select one or more collection names.
            • Include targets already in an active maintenance cycle in another collection: Select this checkbox if you want to add targets that are already in an active maintenance cycle in another collection.

              Note:

              Each target can only belong to one active maintenance cycle at a time. Adding targets that are already in an active maintenance cycle in another collection will not allow a maintenance cycle to be created until the other maintenance cycle(s) have been completed or these targets have been removed from the collection.

            • Tags: (Optional) You can choose to apply tags. If you have permission to create a resource, then you also have permission to apply free-form tags to that resource. To apply a defined tag, you must have permission to use the tag namespace. For more information about tagging, see Resource Tags. If you are not sure if you should apply tags, then skip this option (you can apply tags later) or ask your administrator.

              Note:

              If you attempt to clear a compartment, then the system displays the Clear associated criteria dialog box to clear the associated criteria first. Similarly, if you attempt to clear an Exadata infrastructure, then the system displays the Clear associated criteria dialog box to clear the associated criteria first.

            • Click Apply.
          • Guest VM OS software update:
            • Exadata image major version: Choose the latest Exadata image versions.
            • Exadata image minor version: Choose the latest or any of the last three Exadata image versions (four options in total).
            • Exadata infrastructure: Select one or more Exadata infrastructures.
            • VM cluster: Select one or more VM Clusters.

              This field is disabled until you select an Exadata infrastructure. When enabled, this field displays only the VM Clusters that belong to the selected compartments and infrastructures.

            • Collection name: Select one or more collection names.
            • Include targets already in an active maintenance cycle in another collection: Select this checkbox if you want to add targets that are already in an active maintenance cycle in another collection.

              Note:

              Each target can only belong to one active maintenance cycle at a time. Adding targets that are already in an active maintenance cycle in another collection will not allow a maintenance cycle to be created until the other maintenance cycle(s) have been completed or these targets have been removed from the collection.

            • Tags: (Optional) You can choose to apply tags. If you have permission to create a resource, then you also have permission to apply free-form tags to that resource. To apply a defined tag, you must have permission to use the tag namespace. For more information about tagging, see Resource Tags. If you are not sure if you should apply tags, then skip this option (you can apply tags later) or ask your administrator.

              Note:

              If you attempt to clear a compartment, then the system displays the Clear associated criteria dialog box to clear the associated criteria first. Similarly, if you attempt to clear an Exadata infrastructure, then the system displays the Clear associated criteria dialog box to clear the associated criteria first.

          • Grid Infrastructure and Guest VM OS software update:
            • GI major version: Choose either 19c or 23ai as the Grid Infrastructure release.

              Note:

              The selected Oracle Grid Infrastructure release determines which Oracle Database versions are supported on the VM cluster.

              You cannot provision an Oracle Database version that is newer than the selected Grid Infrastructure version. For example, to provision a 23ai database, you must choose the 23ai Grid Infrastructure release.

              Note:

              To provision a VM cluster with Grid Infrastructure 23ai, the following minimum software versions are required:

              • Exadata Guest VM running Exadata System Software 23.1.8
              • Exadata Infrastructure running Exadata System Software 23.1.x
            • GI minor version: Choose the latest or any of the last three Grid Infrastructure releases (four options in total). For example, the available Grid Infrastructure versions include: 19.24.0.0.0 (latest), 19.23.0.0.0, 19.22.0.0.0, and 19.21.0.0.0.
            • Exadata image major version: Choose the latest Exadata image versions.
            • Exadata image minor version: Choose the latest or any of the last three Exadata image versions (four options in total).
            • Exadata infrastructure: Select one or more Exadata infrastructures.
            • VM cluster: Select one or more VM Clusters.

              This field is disabled until you select an Exadata infrastructure. When enabled, this field displays only the VM Clusters that belong to the selected compartments and infrastructures.

            • Collection name: Select one or more collection names.
            • Include targets already in an active maintenance cycle in another collection: Select this checkbox if you want to add targets that are already in an active maintenance cycle in another collection.

              Note:

              Each target can only belong to one active maintenance cycle at a time. Adding targets that are already in an active maintenance cycle in another collection will not allow a maintenance cycle to be created until the other maintenance cycle(s) have been completed or these targets have been removed from the collection.

            • Tags: (Optional) You can choose to apply tags. If you have permission to create a resource, then you also have permission to apply free-form tags to that resource. To apply a defined tag, you must have permission to use the tag namespace. For more information about tagging, see Resource Tags. If you are not sure if you should apply tags, then skip this option (you can apply tags later) or ask your administrator.

              Note:

              If you attempt to clear a compartment, then the system displays the Clear associated criteria dialog box to clear the associated criteria first. Similarly, if you attempt to clear an Exadata infrastructure, then the system displays the Clear associated criteria dialog box to clear the associated criteria first.

      • Apply Search Criteria

        The search may take a few minutes to complete. Results will be displayed once they are available.

        • To cancel the search:
          1. Click Cancel Search.

            Note:

            Leaving the search page or canceling the search before it completes will result in no results returned.

          2. A Cancel Search confirmation dialog will appear.

            Click Cancel Search to confirm.

          3. If you selected the option to include targets in active maintenance cycles, an information block will appear.
          4. To exclude those targets, click Unselect Targets in Active Maintenance Cycle.
        • To change search criteria::
          • If you change the collection type, cloud service, or current major version, all selected filters and search results will be cleared.
          • A confirmation dialog will appear with the message:
            Changing value will clear target search results.
          • Click Change Value and Clear Target Search Results to proceed.
  3. Click Create.

View the List of Collections

To the list of collections and filter them compartment and state, use this procedure.

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

    Under Exadata Fleet Update, Collections is selected by default.

Filter Collections by Compartment

To find Collections specific to an individual compartment, you can use List Scope to filter Collections by compartment

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

    Under Exadata Fleet Update, Collections is selected by default.

  2. Under List Scope, select a compartment from the list.

Filter Collections by State

Filter Collections by selecting a state from the list of states.
  1. Open the navigation menu. Under Oracle Database, click Exadata Fleet Update.

    Under Exadata Fleet Update, Collections is selected by default.

  2. Under Filters, select a state from the list.

View the Details of a Collection

To the details of a collections, use this procedure.

  1. Open the navigation menu. Under Oracle 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 view details.

    Collection details page is displayed.

Add Targets to an Existing Collection

Add targets that are not part of an active maintenance cycle.

  1. Open the navigation menu. Under Oracle 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 add targets.

    Collection details page is displayed.

    Under Resources, Targets is selected by default.

    The Target section displays the list of targets in the collection.

  3. Click Add Targets.

    Add Targets page is displayed.

  4. Click Edit search criteria.

    Edit search criteria screen is displayed.

  5. Select a compartment from where you want to search the targets.

    Targets may be added from multiple compartments to a collection.

  6. Click Another compartment to add more compartments to expand your search.
  7. Click Apply search criteria.

    The search may take a few minutes to complete. Results will be populated once they are available.

    If the search result includes targets that are already part of an active maintenance cycle, then a banner is displayed with an option to Unselect targets in active maintenance cycle.

    The Database name includes appropriate information and warning icons to indicate whether the targets are already part of this collection or they are part of collections that are part of an active maintenance cycle.

    Note:

    • If a collection is part of an active maintenance cycle and the targets are also part of an active maintenance cycle in another collection, then those targets will be disabled and may not be added to this collection.
    • If the Collection has an active Maintenance cycle and if you try to add Targets after a successful Stage software Acion, then the system displays an alert message indicating that you will have to rerun the Stage software action after adding the Targets.
    • If you try to add or remove Targets after an Apply update Action has run but not successfully completed, then the system displays an alert message indicating that you cannot add or remove Targets until the Apply update Action completes successfully.
    • If the targets are not part of an active maintenance cycle, then those targets will be enabled and can be added to this collection.

    The Select targets from all pages and Unselect targets from all pages buttons are displayed only when the search returns 21 or more targets.

  8. Click Next.
  9. Review the list of selected targets and then click Add Targets.

    The status of the collection changes to Updating.

  10. Under Resources, click Work requests to view the progress.

The status of the collection changes to Available when adding targets to the collection completes successfully.

Remove Targets from an Existing Collection

To remove targets from a collection, be prepared to provide values for the fields required for removing the targets.

Note:

If you try to add or remove Targets after an Apply update Action has run but not successfully completed, then the system displays an alert message indicating that you cannot add or remove Targets until the Apply update Action completes successfully.
  1. Open the navigation menu. Under Oracle 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 add targets.

    Collection details page is displayed.

    Under Resources, Targets is selected by default.

    The Target section displays the list of targets in the collection.

  3. Click Remove targets, or in the list of targets, click the Actions icon (three dots) for a target, and then click Remove Target.

    Remove Targets page is displayed.

  4. Click Edit search criteria to identify the targets to remove.

    Edit search criteria screen is displayed.

  5. Enter appropriate values to narrow down your search criteria.

    For example, select Exadata infrastructure and the associated VM Clusters.

  6. Click Select targets from all pages.
  7. Review the list of selected targets.
  8. Click Remove targets.

    The status of the collection changes to Updating.

  9. Under Resources, click Work requests to view the progress.

The status of the collection changes to Available when removing targets from the collection completes successfully.

Edit a Collection

You can only edit the name of the collection.

  1. Open the navigation menu. Under Oracle 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 Edit.

    Edit collection dialog is displayed.

  4. Edit the name and the click Save.

Move a Collection to a Different Compartment

To change the compartment that contains your Collection, use this procedure.

  1. Open the navigation menu. Under Oracle 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 move.

    Collection details page is displayed.

  3. Click Move Resource.

    Move Resource to a Different Compartment dialog is displayed.

  4. Choose a compartment where you want to move the resource, and then click Submit.

Delete a Collection

Be cautious, you cannot recover a deleted Collection.

  1. Open the navigation menu. Under Oracle 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 delete.

    Collection details page is displayed.

  3. Click Delete.

    Or, click the Actions icon (three dots), and then click Delete..

    Delete dialog is displayed.

  4. Enter the name of the Collection, and then click Delete.