Oracle Cloud Infrastructure Documentation

Bundle Your Application Artifacts

About Bundles

Bundles are snapshots of your application artifacts such as configurations and customizations at a certain point in time.

Bundles work on environments where the source and target are at the same level or the source is at a lower version and the target is at a higher version. For example, a bundle generated from a previous content version works on the latest content version.

Bundles enable you to:
  • Package custom development by defining a bundle that represents a subset of application artifacts in an environment such as development, test, or production.
  • Migrate custom development and deploy the bundle on a target environment.
  • Synchronize instances by promoting changes from one environment to another such as production to test.
  • Restore the system when something goes wrong with an environment and you need to do a complete system restore.
  • Create a backup of the environment or subset of application to save current state of the artifacts.
  • Restore artifacts by importing from a bundle to restore state of the relevant artifacts to what was in the bundle.

You can bundle your application artifacts as:

  • Data Config bundle: This includes pipeline parameters, activation metadata, data augmentations, and custom data configurations. You can install this bundle in an existing environment after a hard data reset. This is useful to leave content as-is and reset the data pipeline.
  • Semantic Model bundle: This includes main branch, tags, custom branch, duty and data roles for semantic extension.
  • Security bundle: This includes custom application roles, custom groups, and custom data security.
  • Content bundle: This includes snapshots of Oracle Analytics Cloud folders, projects, dataset definitions,workbooks, key metrics, duty roles for content, and report parameters. The content bundle always merges the catalog content from source to target. While merging, if any conflicts are found, it replaces the content. It doesn't track the deleted content.
  • Composite bundle: This includes one or more of the other bundles.
  • Environment bundle: This includes all artifacts of a specific environment to revert to a known state of system. For example, at the end of every week, the service administrator can create a bundle called DevEnv_YYMMDD to maintain a backup of the environment. You must first deploy the data configuration bundle or manually activate your data pipelines before deploying the environment bundle.
Note

Ensure that you've activated the functional areas and data is available prior to working with the semantic models or content. Either manually configure and activate your data pipelines in the target environment, or deploy a Data Config bundle to ensure that configurations and activations are at the same level as the source environment. Only then, it makes sense to deploy an Environment bundle, Semantic bundle, or Composite bundle since they depend on data.
Follow these recommended practices to ensure a smooth experience:
  • Ensure that you include the applicable security-related information in the Semantic Model and Content bundles.
  • The Security bundle doesn’t overwrite the user-group mappings; hence you must reassign the groups to the users.
  • Ensure that you include the security configuration when you’re exporting a Semantic Model bundle from a test to production environment.
  • Ensure that the semantic model extension steps have unique names for the tags to work correctly while using the Content bundle to migrate your content to the target instance.

What’s Available In Bundles

Learn what's available in bundles.

Area Artifact Included in Bundles
Security Application roles Security and Environment
Security Users and Groups No – move manually, done in Identity Cloud Service
Security Group to Role assignments Security and Environment
Security Security contexts including Configurable Context No – move manually
Uploaded files Financial Categories, Security assignments No – move manually
System settings Oracle Analytics Cloud system settings including Preview features No – create manually in target environment
Enable features Activated Oracle Fusion Analytics Warehouse features No – create manually in target environment
Semantic model extensions System, user, security configuration Semantic and Environment
Data validations Scheduled validations such as AP Invoices, weekly No – create manually in target environment
Oracle Analytics Cloud content    
Key metrics, Workbooks, Connections, Analyses Content and Environment  
Data flows, Functions, Machine Learning apps Environment  
Key metrics No – create service request  
Datasets No – move manually  
Reporting configurations Basic reporting configurations Content
Reporting configurations Advanced (Configurable Account Analysis) No – create manually in target environment
Data pipeline Pipeline parameters, functional areas, augmentations Data configurations
Data pipeline Frequent refresh modules, tables, prioritized refresh No – create manually in target environment
Data pipeline Warehouse full reload schedules No – create manually in target environment
Data pipeline Custom data configurations – DFFs, custom applications such as Configurable Account Analysis No – create manually in target environment
Connections Data Augmentation Connectors No – create manually in target environment
Oracle Cloud Infrastructure Console settings Entitlements, connections, PaaS component settings No – create manually in target environment
Oracle Autonomous Data Warehouse custom schema OAX_USER schema objects and data No – use data pump to back up to and restore from Oracle Object Storage Service

Create a Bundle

Create a snapshot of your application artifacts to save their current state. You can view the bundles that you created on the Bundles page.

While creating a bundle in your source instance, ensure that you select only the data sources that are also available in the target instance to avoid deployment failures in the target instance.

  1. Sign in to your service.
  2. In Oracle Fusion Analytics Warehouse Console, click Bundles under Application Administration.
  3. On the Bundles page, click Create.

    Description of fawag_bundles_create.png follows

  4. In Create Bundles, select the type of bundle that you want to create. For example, Content Bundle.

    Description of fawag_create_bundle.png follows

  5. Enter a name and description for your bundle.
  6. Depending on the type of bundle, select the applicable option and then click Save:
    • For a content bundle, select the Include All Content check box, or select the applicable Oracle Analytics Cloud content, workbooks, and key metrics using the corresponding toggles and buttons. You can select the Include Users Security and Include Reporting Parameters check boxes.
      Description of fawag_content_bundle.png follows

    • For a data config bundle, select the Include all data configuration settings check box, or select the applicable modules, augmentations, and custom data configurations using the corresponding toggles and buttons.
      Description of fawag_data_config_bundle.png follows

    • For a semantic extensions bundle, select the Include all semantic extensions check box, or select the Publish a branch or tag in the target environment check box and select the applicable option from the dropdown list, or select applicable tags and branches using the corresponding toggles and buttons.
      Description of fawag_semantic_extensions_bundle.png follows

    • For a security bundle, select the Include all security settings check box, or select either the groups or application roles or both using the corresponding toggles and buttons.
      Note

      If you've uptaken the enhanced security capability of Oracle Fusion Analytics Warehouse, then you no longer can specifically select groups as part of the Security bundle. See About Managing Users, Groups, Application Roles, and Data Access.

      Description of fawag_security_bundle.png follows

    • For an environment bundle, provide a name.
      Description of fawag_environment_bundle.png follows

    • For a composite bundle, select any of the other bundles.
      Description of fawag_composite_bundle.png follows

Edit a Bundle

Edit a bundle if you need to change the application artifacts captured in the bundle.

  1. Sign in to your service.
  2. In Oracle Fusion Analytics Warehouse Console, click Bundles under Application Administration.
  3. On the Bundles page, hover over the bundle that you created and click under Actions.
  4. From Actions, select Edit.

    Description of fawag_bundles_actions_edit.png follows

  5. On the applicable bundles page, make your changes and then click Update.

Publish a Bundle

Publish a bundle from the source environment. This action generates a snapshot of the application artifacts and saves the snapshot to a repository. You can download this bundled artifact and take to different instances.

  1. Sign in to your service.
  2. In Oracle Fusion Analytics Warehouse Console, click Bundles under Application Administration.
  3. On the Bundles page, hover over the bundle that you created and click under Actions.
  4. From Actions, select Generate to create and publish the bundle.

    Description of fawag_bundles_actions_generate.png follows

You see the bundle with Generated status on the Bundles page.

Export a Bundle

Export the bundle .aab file from your source system to a repository or your local machine.

Tutorial icon LiveLabs Sprint

  1. Sign in to your service.
  2. In Oracle Fusion Analytics Warehouse Console, click Bundles under Application Administration.
  3. On the Bundles page, hover over the bundle that you created and click under Actions.
  4. From Actions, select Export.

    Description of fawag_bundles_actions_export.png follows

Import a Bundle

Import the bundle .aab file into the target environment from your computer to restore the state of the application to the checkpoint represented by the bundle.

  1. Sign in to your service.
  2. In Oracle Fusion Analytics Warehouse Console, click Bundles under Application Administration.
  3. On the Bundles page, click Import.

    Description of fawag_bundles_import_option.png follows

  4. In the Import Bundle dialog, click in Drag and Drop, and then select the applicable .aab file from your local machine.

    Description of fawag_import_bundle.png follows

  5. Click Import.

Deploy a Bundle

You can deploy a generated bundle in the target environment to revert to state of artifacts represented by the bundle. Oracle Fusion Analytics Warehouse validates the bundle before attempting any deployment to ensure software and model versions and any other dependencies are met.

For example, if you have a bundle A (created in instance A) and then later made some changes but want to revert those changes, then use the Deploy option. This option restores the artifacts to an older version by deploying the previous bundle in the system.
  1. Sign in to your service.
  2. In Oracle Fusion Analytics Warehouse Console, click Bundles under Application Administration.
  3. On the Bundles page, hover over the bundle that you created and click under Actions.
  4. From Actions, select Deploy.

    Description of fawag_bundles_actions_deploy.png follows

  5. In the Deploy Bundle dialog, ensure that you see the bundle that you have selected.
  6. Click Deploy.

Delete a Bundle

Delete a bundle if you no longer require the snapshot of your application artifacts captured in the bundle.

  1. Sign in to your service.
  2. In Oracle Fusion Analytics Warehouse Console, click Bundles under Application Administration.
  3. On the Bundles page, hover over the bundle that you created and click under Actions.
  4. From Actions, select Delete.

    Description of fawag_bundles_actions_delete.png follows

View Activity History of Bundles

View all the bundles-related activities to understand the changes made to your instance, which bundles to use, and whether the existing bundles are still current. This information enables you to make informed decisions about creating updated bundles or deploying an existing bundle.

You see all the activities by bundle-related action, bundle names, bundle type, status, user who performed the activity, and date. You can organize the display by sorting columns, searching for activities, and filtering by action, bundle type, or status.
  1. Sign in to your service.
  2. In Oracle Fusion Analytics Warehouse Console, click Bundles under Application Administration.
  3. On the Bundles page, click the Activity tab.

    Activity tab on the Bundles page